Firebase Functions V2部署报错：SyntaxError: Cannot use import statement outside a module at wrapSafe

Hey，我看到你在开发Firebase Functions V2时遇到了这个模块相关的语法错误，刚好这个问题挺常见的，我来帮你理清楚怎么解决~

你提到自己正在做App聊天消息的设备通知功能，现在只是想读取快照内容，但部署时就碰到了这个报错：

SyntaxError: Cannot use import statement outside a module at wrapSafe

你提供的报错截图里能看到：控制台在部署过程中抛出了上述语法错误，同时显示了对应的调用栈信息，指向了wrapSafe相关的代码位置。

这个错误本质是Node.js默认把你的函数文件当成了CommonJS模块来解析，而你在代码里使用了ES模块特有的import语法，两者不兼容才导致了报错。解决方法很简单，按下面的步骤来操作：

• 首先打开你的函数项目根目录下的package.json文件，一定要添加"type": "module"这个字段，明确告诉Node.js当前项目是ES模块项目。修改后的package.json示例如下：

{
  "name": "your-functions-project-name",
  "type": "module",
  "dependencies": {
    "firebase-functions": "^4.0.0",
    "firebase-admin": "^11.0.0"
    // 这里放你项目的其他依赖包
  }
}

• 接着确认你的函数代码文件（比如常用的index.js）里的导入语法是标准的ES模块写法，比如：

import { onDocumentCreated } from "firebase-functions/v2/firestore";
import { initializeApp } from "firebase-admin/app";

如果之前你用的是CommonJS的require语法，也可以统一改成import，保持代码风格一致，避免混淆。

• 要是你是用TypeScript来开发函数的，还要额外检查tsconfig.json的配置，在compilerOptions里确保这两个参数的设置：

{
  "compilerOptions": {
    "module": "ESNext",
    "moduleResolution": "NodeNext"
    // 其他你的TypeScript编译配置
  }
}

这样TypeScript编译出来的代码才会完全符合ES模块的规范，部署时就不会再出现模块语法的报错了。

• 最后重新运行部署命令：firebase deploy --only functions，应该就能顺利完成部署啦。

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