Firebase JS SDK中Timestamp序列化问题的分析与解决

问题背景

在使用Firebase JS SDK（特别是Firestore模块）进行开发时，开发者可能会遇到一个令人困惑的错误：当尝试将Timestamp对象写入Firestore时，系统报错提示"Unsupported field value: a custom pr/at object"。这个问题的根源在于项目中存在多个不同版本的Firebase SDK实例。

问题现象

开发者在本地环境测试时功能正常，但在部署后出现以下错误信息：

FirebaseError: Function setDoc() called with invalid data. Unsupported field value: a custom pr object (found in field value.creationTime in document experiments/202402-test/meta/info)

当开发者切换压缩工具后，错误信息中的类名从"pr"变为"at"，这表明问题与代码压缩无关，而是更深层次的版本冲突问题。

根本原因分析

经过深入调查，发现问题源于项目中存在多个不同版本的Firebase SDK：

1. 主应用依赖firebreather包，该包正确使用了Firebase 10.1.0版本
2. 项目中某些演示代码依赖了旧版Firebase 9.6.1
3. 主应用直接引用了Timestamp类，但没有在package.json中显式声明对firebase/firestore的依赖

这种版本不一致导致以下问题：

• 开发服务器(vite serve)可能使用了正确的版本(10.1.0)
• 生产构建(vite build)却混合使用了10.1.0和9.6.1两个版本
• 不同版本的Timestamp类无法互相识别，导致序列化失败

解决方案

解决这个问题有以下两种方法：

1. 统一依赖版本：

   • 检查项目中所有包的依赖关系
   • 确保所有依赖firebase的包都使用相同版本
   • 更新老旧依赖到最新稳定版

2. 显式声明依赖：

   • 在任何直接使用Firebase模块的地方
   • 确保package.json中明确声明了对相应模块的依赖
   • 避免隐式依赖带来的版本不确定性

技术深入

Firebase SDK中的Timestamp类在不同版本间存在兼容性问题，主要是因为：

• 类实例的识别依赖于构造函数引用
• 当两个版本共存时，它们实际上是不同的类
• 即使API相同，实例也无法跨版本识别

这种问题不仅限于Timestamp类，也可能出现在其他Firebase提供的自定义类型中。

最佳实践建议

1. 依赖管理：

   • 使用yarn resolutions或npm overrides强制统一版本
   • 定期检查并更新依赖关系
   • 使用依赖分析工具检测版本冲突

2. 构建配置：

   • 确保构建工具能正确处理peerDependencies
   • 考虑使用模块联邦等高级特性处理复杂依赖

3. 错误处理：

   • 对Firestore写入操作添加适当的错误处理
   • 记录详细的错误信息以便快速诊断

总结

Firebase SDK版本冲突是Web开发中常见的问题，特别是在大型项目或monorepo中。通过规范依赖管理、显式声明依赖关系，可以避免类似Timestamp序列化失败的问题。开发者应当建立定期的依赖检查机制，确保项目依赖的健康状态。