Google Cloud Go Firestore 查询中 != nil/NaN 操作符的异常行为分析与修复

在 Google Cloud Go 的 Firestore 客户端库中，开发人员最近发现了一个关于查询操作符的异常行为。当使用 != 操作符来查询非 nil 或非 NaN 值时，查询结果与预期不符，反而返回了等于 nil 的文档。

这个问题的根源在于客户端库对 != nil 和 != NaN 查询条件的处理逻辑存在缺陷。在底层实现中，库未能正确地将这些查询条件映射到 Firestore 的 IS_NOT_NULL 和 IS_NOT_NAN 操作符上。

在正常的 Firestore 查询语义中：

• field != nil 应该返回所有 field 不为 null 的文档
• field != NaN 应该返回所有 field 不是 NaN 的文档

然而，当前实现中，这些查询被错误地转换为了等于查询，导致返回了完全相反的结果集。这种错误行为特别容易影响那些需要筛选出有效数据的应用场景。

修复方案的核心在于修改 PropertyPathFilter 结构体的 toProto 方法。当检测到 != 操作符与 nil 或 NaN 值结合使用时，应该将对应的 IS_NULL 和 IS_NAN 操作符转换为它们的否定形式 IS_NOT_NULL 和 IS_NOT_NAN。

这个修复不仅解决了功能性问题，还保持了 API 的一致性。开发人员可以继续使用直观的 != 操作符来表达他们的查询意图，而无需了解底层实现细节。

对于使用 Firestore 的开发人员来说，这个修复意味着：

1. 查询行为现在与预期一致，符合直觉
2. 不需要改变现有的查询代码即可获得正确结果
3. 可以放心地使用 != 操作符来排除 null 或 NaN 值

这个问题提醒我们，在处理数据库查询抽象层时，必须确保高级操作符能够准确映射到底层数据库的原生操作。特别是在处理特殊值和否定条件时，需要格外小心以避免语义上的歧义。