Firebase Firestore使用withConverter时fromFirestore不是函数如何解决

问题原因排查及解决方案 #

这个报错本质是你传入withConverter()的参数不符合Firestore要求的converter格式，对象上不存在fromFirestore方法，90%以上的场景是导入错误导致的，以下是具体排查步骤：

1. 优先检查导入语法（最高概率） #

你在City类所在文件的导出是把cityConverter挂在导出对象的属性上，如果云函数文件中导入时没有正确解构，就会把整个导出对象当成converter传入：

• 错误导入写法示例：

// 错误：导入的是包含City和cityConverter的整体对象，不是converter本身
const cityConverter = require('./你的City类文件路径.js')

• 正确导入写法：

// 解构取出converter
const { cityConverter } = require('./你的City类文件路径.js')

2. 优化导出写法避免问题 #

你当前分两次赋值导出的写法虽然合法，但容易出现遗漏，建议统一改为一次性导出：

// 把原来的两段导出代码替换为这一段即可
module.exports = {
  City,
  cityConverter
};

3. 验证converter有效性 #

可以在云函数调用withConverter之前加一行日志打印确认converter格式正确：

console.log(cityConverter)
// 正常打印结果应该包含toFirestore、fromFirestore两个方法

4. 低版本SDK兼容问题 #

如果以上步骤都没问题，检查你项目中的firebase-admin依赖版本，低于9.0.0的版本对withConverter的支持存在缺陷，执行以下命令升级即可：

npm install firebase-admin@latest

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