Swift iOS：如何为Firebase TransactionBlock加定时器限制短时间内递增

这个需求很常见——用户快速来回切换详情页时，总不能每次都给浏览量+1，得加个“冷却期”限制。我给你两种实现思路，分别对应单设备和跨设备的场景，你可以按需选：

核心思路 #

给每个用户+帖子的组合记录最近一次触发浏览量递增的时间戳，每次进入详情页时先对比当前时间和这个时间戳：

• 如果间隔超过你设定的阈值（比如60秒），才执行TransactionBlock递增浏览量，同时更新时间戳
• 如果没超过阈值，直接跳过递增逻辑

方案1：单设备本地存储（简单高效） #

用UserDefaults存储用户最近浏览帖子的时间，适合不需要跨设备同步的场景：

// 先定义冷却阈值，比如60秒
private let viewCooldownThreshold: TimeInterval = 60

func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
    let targetPost = posts[indexPath.row]
    let postID = targetPost.postID
    guard let currentUserID = Auth.auth().currentUser?.uid else {
        // 处理未登录用户的逻辑，比如直接递增或跳过
        navigateToDetailPage(for: targetPost)
        return
    }
    
    // 构造唯一的存储键，区分不同用户和帖子
    let lastViewedKey = "last_viewed_\(currentUserID)_\(postID)"
    let lastViewedTimestamp = UserDefaults.standard.double(forKey: lastViewedKey)
    let currentTimestamp = Date().timeIntervalSince1970
    
    // 检查是否超过冷却期
    if currentTimestamp - lastViewedTimestamp > viewCooldownThreshold {
        // 执行浏览量递增
        incrementPostViews(for: postID)
        // 更新最近浏览时间
        UserDefaults.standard.set(currentTimestamp, forKey: lastViewedKey)
    } else {
        print("跳过递增：帖子\(postID)在冷却期内")
    }
    
    // 跳转到详情页
    navigateToDetailPage(for: targetPost)
}

// 你的Firebase TransactionBlock递增逻辑
private func incrementPostViews(for postID: String) {
    let postRef = Firestore.firestore().collection("posts").document(postID)
    
    postRef.runTransaction({ transaction, errorPointer -> Any? in
        let postDoc: DocumentSnapshot
        do {
            try postDoc = transaction.getDocument(postRef)
        } catch let fetchError as NSError {
            errorPointer?.pointee = fetchError
            return nil
        }
        
        guard let currentViews = postDoc.data()?["views"] as? Int else {
            let error = NSError(
                domain: "AppError",
                code: -1,
                userInfo: [NSLocalizedDescriptionKey: "无法获取当前浏览量"]
            )
            errorPointer?.pointee = error
            return nil
        }
        
        transaction.updateData(["views": currentViews + 1], forDocument: postRef)
        return currentViews + 1
    }) { _, error in
        if let error = error {
            print("浏览量递增失败：\(error.localizedDescription)")
        }
    }
}

方案2：跨设备云存储（用户多设备同步） #

如果要确保用户在不同设备上的浏览行为也不会重复计数，就把最近浏览时间存在Firebase的用户文档里：

private let viewCooldownThreshold: TimeInterval = 60

func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
    let targetPost = posts[indexPath.row]
    let postID = targetPost.postID
    guard let currentUserID = Auth.auth().currentUser?.uid else {
        navigateToDetailPage(for: targetPost)
        return
    }
    
    let userDocRef = Firestore.firestore().collection("users").document(currentUserID)
    let currentTimestamp = Date().timeIntervalSince1970
    
    // 先获取用户的最近浏览记录
    userDocRef.getDocument { [weak self] snapshot, error in
        guard let self = self else { return }
        
        if let error = error {
            print("获取用户浏览记录失败：\(error)")
            // 容错：如果获取失败，直接递增并初始化记录
            self.incrementPostViews(for: postID)
            self.updateLastViewedTime(userRef: userDocRef, postID: postID, timestamp: currentTimestamp)
            self.navigateToDetailPage(for: targetPost)
            return
        }
        
        let lastViewedPosts = snapshot?.data()?["lastViewedPosts"] as? [String: Double] ?? [:]
        let lastViewedTimestamp = lastViewedPosts[postID] ?? 0
        
        if currentTimestamp - lastViewedTimestamp > self.viewCooldownThreshold {
            self.incrementPostViews(for: postID)
            self.updateLastViewedTime(userRef: userDocRef, postID: postID, timestamp: currentTimestamp)
        } else {
            print("跳过递增：帖子\(postID)在冷却期内")
        }
        
        self.navigateToDetailPage(for: targetPost)
    }
}

// 更新用户的最近浏览时间到Firestore
private func updateLastViewedTime(userRef: DocumentReference, postID: String, timestamp: Double) {
    userRef.updateData([
        "lastViewedPosts.\(postID)": timestamp
    ]) { error in
        if let error = error {
            print("更新最近浏览时间失败：\(error)")
        }
    }
}

// 这里复用方案1里的incrementPostViews函数即可

关键注意点 #

1. 阈值调整：你可以根据产品需求把viewCooldownThreshold改成30秒、2分钟甚至更久
2. 未登录用户：如果允许匿名用户浏览，你可以用设备ID替代用户ID来存储浏览记录
3. 容错处理：不管是本地存储还是云存储，都要处理获取失败的情况，避免影响用户正常跳转详情页

内容的提问来源于stack exchange，提问作者Lance Samaria