Firebase Functions模拟器执行测试函数报找不到service-account.json等相关报错

1. 初始Cannot find module '../service-account.json'报错 #

该报错与依赖安装、编辑器状态无关，核心原因是TypeScript编译输出的目录层级，和代码内的相对导入路径的运行时解析逻辑不匹配：

• 当前tsconfig未显式配置rootDir，加上include字段同时引入src和test目录，TypeScript会自动取所有引入路径的共同父目录作为编译根，最终将所有src下的代码输出到lib/src/层级下，而非直接平铺到lib根目录。
• 之前残留的旧lib目录存在结构不统一问题：旧编译产物里的shared.js位置与当前新编译的文件位置不一致，导致代码里编写的../service-account.json相对路径，在Node.js运行时无法定位到对应json文件。哪怕VSCode里鼠标悬停显示源文件路径正确，也不代表编译后的运行时路径能匹配——Node.js的模块解析完全基于实际JS文件的磁盘位置计算，和TS源文件的位置无关。
• 你提到的另一个结构、代码完全一致的项目能正常运行，本质是那个项目的tsconfig设置了正确的rootDir，编译输出结构和运行时路径匹配，当前项目遗漏了该配置项。
• 修正方法：
  • 在tsconfig的compilerOptions中显式增加"rootDir": "src"，让TypeScript将src作为编译根，所有src下的文件直接输出到lib根目录，保证编译后的目录层级和源文件完全一致；
  • 每次排查时先彻底删除旧的lib目录再重新编译，不在旧的编译产物上叠加新的编译结果。

2. 重编译后出现的functions.config().app取值报错 #

该报错为环境配置缺失，与代码逻辑无关：

• 报错代表启动模拟器时，未加载到对应项目下配置的app相关环境变量。Firebase的functions config与项目ID、本地凭证绑定，不会随代码目录同步——哪怕当前代码和另一个正常运行的项目完全一致，只要当前关联的项目未设置对应config值，就会触发该报错。
• 修正方法：
  • 进入functions目录，执行firebase functions:config:get确认当前项目下是否存在app.package_name的配置项；
  • 如果缺失，执行对应firebase functions:config:set app.package_name="你的实际包名"命令补全配置；
  • 启动模拟器时确认关联的项目ID与配置所属的项目ID完全一致，避免读错配置来源。

3. TypeScript报Cannot find type definition file for 'express-serve-static-core 2' #

该报错为依赖安装的缓存冲突导致：

• 报错中带数字后缀的express-serve-static-core 2是npm遇到版本冲突时自动生成的重复包副本，TypeScript扫描全局类型定义时会将所有@types下的目录作为合法类型来源，遇到这种带异常后缀的重复目录就会触发报错。
• 修正方法：
  • 删除functions目录下的node_modules、package-lock.json文件，重新执行npm install，避免旧lock文件拉取存在冲突的依赖版本；
  • 如果重新安装后仍报错，手动检查node_modules/@types目录，删除所有带数字后缀的重复包目录（即名称中带空格加数字的xxx 2格式目录）。

注意事项 #

检查当前firebase.json中的functions配置项：由于当前编译输出为lib/src/index.js的结构，需要确认配置中的代码入口路径指向实际的JS文件位置，不要直接沿用项目模板默认的lib/index.js路径，否则模拟器会因找不到入口文件反复加载失败。

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