Google App Engine部署NestJS时TS编译器无法解析非相对导入路径

问题根因 #

本地开发和线上部署的运行逻辑存在本质偏差：

• 本地执行npm run start:dev时，Nest CLI 内置了tsconfig-paths运行时解析能力，即便存在src/xxx这类非相对导入，也会在启动阶段按tsconfig的baseUrl规则动态映射到对应源码文件，因此本地运行完全正常
• 线上GAE环境执行自定义的gcp-build纯tsc编译流程时，TypeScript编译器仅做类型校验和语法降级，不会主动改写代码里的非相对导入路径——哪怕已经配置了baseUrl: "./"，tsc也只会在类型检查、IDE提示阶段提供路径补全支持，完全不会修改编译产物里的require语句。最终生成的dist目录中，代码仍保留原始的require("src/auth/auth.service")写法，Node运行时会错误地去node_modules目录查找名为src的依赖，自然抛出模块找不到的错误。

无需逐行修改业务导入的实操解决步骤 #

• 安装编译阶段的路径自动改写工具，直接在编译流程中完成路径适配，不需要改动任何业务代码
  执行安装命令：npm install --save-dev tsc-alias
• 修改package.json中的gcp-build脚本，在tsc完成语法转译后自动执行路径替换
  原脚本配置：

  "gcp-build": "tsc -p tsconfig.build.json"
  

  修改为：

  "gcp-build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json"
  

  注意这里要指定tsconfig.build.json作为tsc-alias的配置来源，和tsc实际编译时读取的配置保持完全一致。
• 确认tsconfig.build.json中继承了根目录的baseUrl: "./"配置（Nest默认的build配置本身就会继承根tsconfig的所有配置，正常不需要额外调整，若有自定义路径映射规则要同步到编译用的tsconfig中）
• 本地先模拟线上编译流程验证：执行npm run gcp-build后，检查dist目录下对应编译文件的require语句，确认原来的非相对路径已经被替换为Node可识别的正确相对路径，验证通过后再执行npm run deploy重新部署即可解决报错。

备选适配方案（无额外编译依赖） #

如果不想引入编译阶段的额外依赖，也可以在Node启动时通过预加载插件实现路径解析，缺点是启动阶段的路径解析会带来极少量性能开销：

• 将tsconfig-paths安装为生产依赖：npm install --save tsconfig-paths
• 修改app.yaml中的应用启动入口，加上预加载配置：

  entrypoint: node -r tsconfig-paths/register dist/main.js
  

  这种方式不需要调整编译流程，Node启动时会先读取tsconfig的路径规则，动态解析所有非相对导入，GAE默认会将tsconfig.json上传到运行目录，不需要额外配置即可正常运行。

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