Firebase Functions中TypeScript使用baseURL导入模块找不到的解决方法咨询

问题根源 #

TypeScript 的 baseUrl 和 paths 仅作为编译时路径映射存在，Node.js 运行时并不识别这些配置。当你使用 import 'Commons/utilities' 这类绝对路径导入时，TS 编译后的 JS 文件会保留原路径，而 Node.js 会默认去 node_modules 目录查找该模块，自然找不到；相对路径编译后会保留正确的层级引用，因此可以正常工作。

修复方案 #

方案1：用 tsc-alias 替换编译后的路径为相对路径（推荐用于部署场景） #

该方案会在编译阶段将绝对路径自动替换为 Node.js 能识别的相对路径，无需运行时额外依赖：

1. 安装依赖：

npm install tsc-alias --save-dev

2. 修正 tsconfig.json 的路径配置：

{
  "compilerOptions": {
    "module": "commonjs",
    "noImplicitReturns": true,
    "noUnusedLocals": true,
    "outDir": "lib",
    "sourceMap": true,
    "strict": true,
    "target": "es2017",
    "baseUrl": "./src",
    "paths": {
      "*": ["./*"] // 匹配 src 下所有目录的绝对路径导入
    }
  },
  "compileOnSave": true,
  "include": ["src"]
}

3. 修改 package.json 的构建脚本：

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

执行构建后，lib/Main/main.js 中的 import 'Commons/utilities' 会被自动替换为 import '../Commons/utilities'，Node.js 即可正常解析。

方案2：用 tsconfig-paths 处理运行时路径解析 #

适合本地开发调试，通过工具在运行时识别 TS 的路径配置：

1. 安装依赖：

npm install tsconfig-paths --save-dev

2. 同方案1修正 tsconfig.json 的 paths 配置。
3. 修改启动脚本：

{
  "scripts": {
    "build": "tsc",
    "serve": "ts-node -r tsconfig-paths/register src/Main/main.ts && firebase emulators:start --only functions",
    "deploy": "npm run build && firebase deploy --only functions"
  }
}

验证步骤 #

1. 在 main.ts 中使用绝对路径导入：

import { 你的工具函数 } from 'Commons/utilities';

2. 执行 npm run build 查看编译后的 JS 文件路径是否正确。
3. 启动本地模拟器或部署到 Firebase 验证功能正常。

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