如何解决tsoa生成路由与编译后TypeScript文件的路径问题？

你遇到的情况是：用TypeScript写Express API，通过tsoa生成路由文档，源码放/src，编译后输出到/dist，但生成的dist/routes.js里控制器引用路径还是指向源码目录../src，比如：

const LocationController_1 = require("./../src/controllers/LocationController");

手动改成./controllers/LocationController才能正常运行，但路由文件是自动生成的，不能每次都手动修改。下面给你几个可行的解决办法：

1. 修正tsconfig.json的路径映射 #

补全路径别名配置，确保TypeScript和tsoa都能正确识别：

{
  "compilerOptions": {
    "target": "ES6",
    "module": "CommonJS",
    "lib": ["DOM", "ES6", "ESNext.AsyncIterable"],
    "sourceMap": true,
    "outDir": "./dist",
    "rootDir": "./src",
    "baseUrl": "./",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true,
    "strictPropertyInitialization": false,
    "resolveJsonModule": true,
    "paths": {
      "@controllers/*": ["./src/controllers/*"] // 源码路径别名
    }
  },
  "include": ["src/**/*"]
}

2. 调整tsoa.json的关键配置 #

让tsoa直接把路由文件生成到dist目录，同时同步路径配置：

{
  "entryFile": "src/server.ts", // 替换成你的实际入口文件路径
  "controllerPathGlobs": ["src/controllers/**/*.ts"], // 直接指定源码控制器路径
  "routes": {
    "routesDir": "dist", // 路由文件直接输出到dist，避免二次编译路径混乱
    "middleware": "express"
  },
  "spec": {
    "outputDirectory": "dist"
  },
  // 同步tsconfig的路径配置，让tsoa生成路由时用正确的相对路径
  "compilerOptions": {
    "baseUrl": "./",
    "paths": {
      "@controllers/*": ["./src/controllers/*"]
    }
  }
}

3. 整合构建命令 #

把tsoa生成和TypeScript编译放到同一个命令里，确保执行顺序正确：

// package.json的scripts字段
{
  "build": "tsoa routes && tsoa spec && tsc",
  "start:prod": "node dist/server.js"
}

4. 避开tsconfig-paths的坑 #

如果之前试过tsconfig-paths，注意它仅在开发环境生效，生产环境要么用tsconfig-paths/register启动服务，要么直接让tsoa生成正确路径的路由——后者更省心，不需要额外依赖。

为什么之前的配置没生效？ #

• 之前的@controllers/路径少了末尾的*，导致别名匹配不完整
• tsoa.json里直接用@controllers/*作为控制器路径，tsoa不会自动读取tsconfig的别名，必须在tsoa的compilerOptions里同步配置
• 之前路由文件可能先生成在src目录再编译到dist，导致路径引用被带偏，直接生成到dist就不会有这个问题

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