如何在Firebase云函数中使用import导入npm模块？

一、核心配置步骤（TypeScript项目） #

1. 修正functions/package.json配置 #

• 必须添加"type": "module"声明当前是ES模块项目
• main字段要指向编译后的JS文件（不是src下的TS源文件，Firebase运行的是编译产物）
• 调整scripts，确保启动模拟器前先完成编译
  示例关键配置：

  {
    "name": "functions",
    "type": "module",
    "main": "lib/index.js",
    "scripts": {
      "build": "tsc",
      "serve": "npm run build && firebase emulators:start --only functions",
      "deploy": "firebase deploy --only functions"
    }
    // 其他依赖、配置项...
  }
  

2. 调整tsconfig.json关键参数 #

• module设为ESNext或ES2020+，确保编译出ES模块语法的JS
• moduleResolution设为NodeNext或Node16，遵循Node.js的ES模块解析规则
• target设为ES2020或更高，保证编译后的代码兼容Node.js环境
• outDir对应package.json里的main路径（比如lib）
  示例关键配置：

  {
    "compilerOptions": {
      "module": "ESNext",
      "moduleResolution": "NodeNext",
      "target": "ES2020",
      "outDir": "./lib",
      "rootDir": "./src",
      "esModuleInterop": true,
      "strict": true,
      "skipLibCheck": true
    },
    "include": ["src/**/*"],
    "exclude": ["node_modules", ".firebase", "lib"]
  }
  

3. 统一使用ES模块导入语法 #

所有依赖导入都换成import，比如：

import { initializeApp } from "firebase-admin/app";
import { getFirestore } from "firebase-admin/firestore";
import { onRequest } from "firebase-functions/v2/https";

initializeApp();
const db = getFirestore();

export const helloWorld = onRequest((request, response) => {
  response.send("Hello from Firebase!");
});

4. 启动模拟器前先编译 #

执行npm run serve（已在scripts里配置了先build再启动模拟器），或者手动先跑npm run build，再启动模拟器。

二、疑问解答 #

关于Firebase文档的require/import说明 #

早期Firebase云函数示例多用CommonJS（require），因为当时Node.js对ES模块支持不成熟。现在Node.js 16+完全支持ES模块，只要配置正确，用import完全可行。文档示例可能更新不及时，但官方是支持ES模块配置的。

ts-node能不能解决这个问题？ #

ts-node可以直接运行TS代码，但Firebase模拟器的工作逻辑是加载编译后的JS文件，所以ts-node不能直接解决这个报错。强行用ts-node修改运行流程不符合Firebase标准工作流，不推荐。还是按标准编译流程配置更稳妥。

三、额外排查步骤 #

• 检查Node.js版本：必须是16.x或更高（Firebase云函数最低支持Node.js 16，ES模块在该版本后支持完善）
• 禁止混合语法：不要在同一个文件里同时用require和import
• 清理缓存：删除.firebase和lib目录，重新编译后再启动模拟器

内容的提问来源于stack exchange，提问作者Thomas David Kehoe