Firebase本地模拟器启动失败：无法加载Functions定义

问题核心 #

你遇到的报错functions/lib/index.js does not exist本质是本地模拟器不会自动构建云函数代码，而生产部署时Firebase CLI会自动执行构建步骤，所以部署正常但模拟器启动失败。

解决步骤 #

1. 手动构建云函数代码
   进入functions目录，执行构建命令：

   cd functions
   npm run build
   

   执行完成后会生成lib目录，包含编译后的js代码。

2. 重新启动模拟器
   返回项目根目录，再次运行：

   firebase emulators:start
   

3. 优化工作流（可选）
   为避免每次启动模拟器都手动构建，可以在项目根目录的package.json中添加组合脚本：

   "scripts": {
     "emulators": "cd functions && npm run build && cd .. && firebase emulators:start"
   }
   

   之后直接运行npm run emulators即可自动构建并启动模拟器。

额外检查项 #

• 确认functions目录的package.json中存在build脚本，比如TypeScript项目通常是：

  "scripts": {
    "build": "tsc",
    "serve": "firebase emulators:start --only functions",
    ...
  }
  

• 检查functions目录下的tsconfig.json，确保outDir设置为"lib"：

  "compilerOptions": {
    "outDir": "./lib",
    ...
  }
  

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