Firebase Functions V2 TypeScript部署失败：模块/类型未找到错误（全新项目也复现）

我太懂你这种在全新项目里还踩坑的崩溃感了——明明跟着文档走，却报一堆模块找不到、类型不匹配的错误，折腾半天还没解决。结合你给出的代码和已经做过的排查，我来帮你梳理下核心问题和解决步骤：

一、先排查TypeScript配置（最可能的根源） #

你没贴出tsconfig.json，但这几乎是V2类型错误的重灾区。Firebase Functions V2的模块结构和类型解析对TS配置有特定要求，建议你把tsconfig.json改成以下标准配置：

{
  "compilerOptions": {
    "module": "CommonJS",
    "noImplicitReturns": true,
    "noUnusedLocals": true,
    "outDir": "lib",
    "sourceMap": true,
    "strict": true,
    "target": "ES2020",
    "moduleResolution": "Node",
    "esModuleInterop": true,
    "skipLibCheck": true
  },
  "compileOnSave": true,
  "include": ["src/**/*"]
}

重点注意：

• moduleResolution设为Node：确保TS能正确解析firebase-functions/v2/xxx这类嵌套模块路径
• skipLibCheck可选：如果还是有第三方类型冲突，开启它可以跳过库的类型检查（临时救急，但建议后续排查类型问题）

二、降级Node.js到官方支持的LTS版本 #

你当前用的是Node 22，但Firebase官方目前推荐的稳定LTS版本是20（18也支持）。新版本Node可能存在模块解析逻辑的变化，导致firebase-functions的V2模块无法被正确识别。

操作步骤：

1. 用nvm（Node版本管理器）安装Node 20：nvm install 20
2. 切换到Node 20：nvm use 20
3. 删除node_modules和package-lock.json，重新执行npm install

三、修正代码里的类型错误 #

你代码里的request.auth报错，核心原因是没有给request参数指定正确的类型。在V2中，onCall的参数类型是CallableRequest，需要显式导入并声明：

// 补充导入CallableRequest类型
import {onCall, HttpsError, CallableRequest} from "firebase-functions/v2/https";
import {defineString} from "firebase-functions/v2/params";
// ...

export const scrapeRecipe = onCall({secrets: ["GEMINI_KEY"]}, async (request: CallableRequest) => {
  // 现在request.auth就能被TS正确识别了
  if (!request.auth) {
    throw new HttpsError("unauthenticated", "You must be logged in.");
  }
  // ... 其余代码不变
});

四、确认依赖版本的兼容性 #

1. 确保firebase-functions是V2对应的版本（v4.x及以上）：
   执行npm list firebase-functions查看版本，如果低于v4，重新安装：

   npm install firebase-functions@latest --save
   

2. 确保firebase-tools是最新版：

   npm install -g firebase-tools@latest
   

最后验证步骤 #

在全新项目里按以下流程操作，确认问题是否解决：

1. 用Node 20初始化项目：firebase init functions，选择TypeScript
2. 替换tsconfig.json为上面的配置
3. 写入你当前的函数代码（记得补充CallableRequest类型）
4. 执行npm run build，如果编译通过，再执行firebase deploy --only functions

按这些步骤走，应该能解决你遇到的模块找不到、类型错误的问题。

内容来源于stack exchange