Firebase Functions部署时_moduleAliases失效，找不到共享模块

问题背景 #

已将本地部分文件夹配置为构建到/lib目录的共享模块，本地运行完全正常，但部署Firebase Functions时出现模块找不到的错误。

报错信息 #

src/routes/stats/types.ts(40,41): error TS2503: Cannot find namespace 'db'.
src/routes/stats/validations.ts(4,34): error TS2307: Cannot find module '@shared_resources/functions/modulesWithoutGP' or its corresponding type declarations.

本地文件位置均正确，怀疑/lib/configs目录未生成，同时想确认部署是否会上传/lib下所有文件夹内容。

核心结论与排查步骤 #

Firebase Functions部署时默认不会自动上传所有/lib目录内容，需从以下几个方向排查：

1. 确保部署前执行了构建脚本 #

本地正常是因为手动执行过构建命令（如tsc）生成了/lib文件，但Firebase CLI不会自动帮你完成构建。需在package.json的scripts中配置预部署流程：

"scripts": {
  "build": "tsc",
  "deploy": "npm run build && firebase deploy --only functions"
}

部署时通过npm run deploy触发，确保构建完成后再上传代码。

2. 检查文件排除规则 #

• 如果/lib被加入.gitignore，Firebase CLI默认会忽略Git排除的文件，需在firebase.json中调整ignore配置，确保/lib不被排除：

  "functions": {
    "ignore": [
      "node_modules",
      ".git",
      "firebase-debug.log",
      "firebase-debug.*.log"
      // 不要包含/lib目录
    ]
  }
  

3. 验证TypeScript构建配置 #

确认tsconfig.json的输出路径和模块映射配置正确：

{
  "compilerOptions": {
    "outDir": "./lib",
    "baseUrl": ".",
    "paths": {
      "@shared_resources/*": ["src/shared_resources/*"]
    }
  }
}

确保所有共享模块的代码都被正确编译到/lib对应路径下，模块别名能被解析。

4. 确认部署包包含目标文件 #

执行firebase deploy --only functions --dry-run查看CLI输出的上传文件列表，检查/lib下的目标文件夹（如configs、shared_resources）是否在上传列表中。

内容的提问来源于stack exchange，提问作者Riël