Angular部署Firebase Functions遇TS类型错误与意外token报错

• 核心配置错误：functions/package.json中的main字段直接指向了TS源文件src/index.ts。Firebase部署的触发器解析阶段会直接用Node.js加载main字段指定的入口文件，Node原生不识别TS类型标注语法，遇到类型声明的冒号就会抛出Unexpected token ':'语法错误。
• 本地模拟器可正常运行的原因：serve脚本手动执行了tsc编译步骤，模拟器实际加载的是编译后输出的JS文件，跳过了直接解析TS源文件的流程，所以不会触发语法错误。
• TS7006隐式any报错是TS严格模式下的正常校验，给参数加类型的解决方向本身没有问题，只是因为入口配置错误，才会在加完类型后触发解析报错。

1. 修正Functions目录入口配置
   打开functions/package.json，将main字段从TS源文件路径修改为编译后JS产物的路径，标准TS项目配置下编译产物默认输出到lib目录：

"main": "lib/index.js",

2. 校验TS编译配置
   打开functions/tsconfig.json，确认编译配置正确，保证TS文件会被编译为纯JS、剥离所有类型标注后输出到lib目录，核心配置参考：

{
  "compilerOptions": {
    "outDir": "lib",
    "rootDir": "src",
    "strict": true,
    "target": "es2020",
    "module": "commonjs"
    // 其余原有配置保持不变即可
  },
  "include": ["src"]
}

3. 修正参数类型（无需写any）
   不需要手动给回调参数加any类型，firebase-functions自带类型定义，只要正确导入，TS会自动推导onRequest回调的参数类型，不会触发隐式any报错。推荐写法：

import * as functions from "firebase-functions";
import * as admin from "firebase-admin";
import axios from "axios";
import cors from "cors";

const corsHandler = cors({origin: true});
admin.initializeApp();
const db = admin.firestore();

// 自动推导request、response类型，无需手动标注
exports.testFunc = functions.https.onRequest((request, response) => {
  corsHandler(request, response, () => {
    response.send(request.body)
  })
})

如果要保留CommonJS的require写法，可以显式标注官方提供的类型，避免使用any：

const functions = require("firebase-functions");
// 其余require语句保持不变
exports.testFunc = functions.https.onRequest((request: functions.Request, response: functions.Response) => {
  cors(request, response, () => {
    response.send(request.body)
  })
})

4. 配置部署前置编译钩子
   打开项目根目录的firebase.json，确认functions配置中包含predeploy钩子，保证部署前会自动执行TS编译：

{
  "functions": {
    "predeploy": [
      "npm --prefix \"$RESOURCE_DIR\" run build"
    ]
    // 其余原有配置保持不变
  }
}

5. 验证部署
   先在functions目录下执行npm run build，确认lib目录生成了无TS语法的纯JS文件，再执行部署命令即可。

• 全局安装的firebase-tools@9.23.3版本过旧，执行npm i -g firebase-tools@latest更新到最新版，可避免大量部署流程的已知解析bug。
• 不要把firebase-admin、firebase-functions这类云函数后端依赖安装在Angular项目根目录的package.json中，这类依赖仅在云函数运行时需要，只保留在functions/package.json里即可，否则会增大前端打包产物体积。

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