Firebase Firestore Timestamp在Swift中解码不准确导致无法等值查询的问题求助

各位好，针对你遇到的这个问题，我来分享下问题根源和可行的解决办法：

问题本质 #

你在Firestore控制台手动设置时间戳时，虽然只指定到了秒级，但Firestore的Timestamp类型本身是带纳秒精度的。控制台在你选择时间后，会自动填充当前的纳秒值（哪怕你没手动设置），这就导致了看似相同的时间戳，实际纳秒部分存在差异，解码后自然没法通过等值查询匹配。

解决方案 #

这里有几个实用的处理方式，你可以根据自己的场景选择：

1. 用范围查询替代等值查询（适配已有数据）

如果已经有大量历史数据不想修改，可以在查询时忽略纳秒，只匹配秒级区间：

// 将目标时间戳截断到秒级，构建区间
let targetSeconds = endDate.seconds
let startOfSecond = Timestamp(seconds: targetSeconds, nanoseconds: 0)
let endOfSecond = Timestamp(seconds: targetSeconds + 1, nanoseconds: 0)

// 查询该秒内的所有文档
firestore
    .collection("products")
    .whereField("end_datetime", isGreaterThanOrEqualTo: startOfSecond)
    .whereField("end_datetime", isLessThan: endOfSecond)
    .getDocuments { snapshot, error in
        // 处理查询结果
    }

这种方式能精准覆盖所有秒级相同的文档，不受纳秒差异影响。

2. 存储时强制统一纳秒为0（从根源解决）

如果是新项目或可以修改存储逻辑，建议存储时就把纳秒设为0：

• 代码存储：

let targetDate = Date()
// 直接构造秒级时间戳，纳秒为0
let timestamp = Timestamp(seconds: Int64(targetDate.timeIntervalSince1970), nanoseconds: 0)

firestore.collection("products").addDocument(data: [
    "end_datetime": timestamp
])

• 控制台手动添加：选择「自定义」时间戳，手动输入秒数，纳秒栏填0，确保所有文档的时间戳完全一致。

3. 解码时截断到秒级（适配展示/本地判断）

如果只需要本地处理时时间戳一致，可以在解码结构体时统一截断：

struct Product: Decodable {
    var end_dateTime: Timestamp?
    
    enum CodingKeys: CodingKey {
        case end_dateTime
    }
    
    init(from decoder: Decoder) throws {
        let container = try decoder.container(keyedBy: CodingKeys.self)
        if let rawTimestamp = try container.decodeIfPresent(Timestamp.self, forKey: .end_dateTime) {
            // 截断到秒级，纳秒设为0
            self.end_dateTime = Timestamp(seconds: rawTimestamp.seconds, nanoseconds: 0)
        } else {
            self.end_dateTime = nil
        }
    }
}

注意：如果用解码后的时间戳去查询，需要确保查询参数也做了同样的截断，否则依然会不匹配。

总结 #

如果已有历史数据，优先选第一种范围查询方案；如果是新项目，推荐第二种从存储层面统一时间戳精度的方案，能彻底避免这类问题。

备注：内容来源于stack exchange，提问作者Timotius Satrio