Jest + ts-jest 栈追踪行号错误问题（与config包相关的source-map问题）

兄弟，我之前踩过几乎一模一样的坑！你说的这种测试失败时栈追踪行号偏移的问题，十有八九是source-map的生成或解析环节出了问题，而且很大概率和config包（就是npm上那个常用的配置模块）有关联，接下来我给你捋捋排查和解决的思路：

首先先明确你的问题场景：

我在做TypeScript/Node后端的单元测试，当测试失败时，Jest的栈追踪指向原源码里的错误行号（差了几行），我怀疑source-map坏了，但找不到问题出在哪。

你提供的最小复现（精简版） #

package.json依赖片段：

"jest": "^29.5.0",
"jest-junit": "^16.0.0",
"jest-mock-extended": "^3.0.4",
"supertest": "^..."

第一步：排查ts-jest和TypeScript的source-map基础配置 #

这是最容易出错的环节，先把基础配置拉满：

1. 检查jest.config.js
   确保ts-jest明确开启source-map生成，同时避免不必要的配置干扰：

module.exports = {
  preset: 'ts-jest',
  testEnvironment: 'node',
  transform: {
    '^.+\\.tsx?$': ['ts-jest', {
      sourceMap: true, // 这个是核心，必须设为true
      diagnostics: false, // 关闭诊断信息，避免干扰排查
    }],
  },
  moduleFileExtensions: ['ts', 'js'],
  collectCoverage: false, // 开启覆盖率有时候会打乱source-map映射，先关掉试试
  cache: false, // 先禁用缓存，避免旧的map文件搞事情
};

2. 检查tsconfig.json
   确保TypeScript编译时生成正确的source-map，不要用inline类型的map：

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "sourceMap": true, // 必须开启
    "inlineSourceMap": false, // 绝对不能开，否则Jest解析会出问题
    "inlineSources": false, // 同上
    "outDir": "./dist",
    "rootDir": "./src"
  },
  "include": ["src/**/*"]
}

第二步：重点排查config包的干扰 #

很多人碰到这个行号偏移问题，根源都是config模块的加载逻辑——它会动态生成代码、修改模块加载路径，直接打乱了source-map的映射关系。这里给你两个解决方案：

方案1：测试环境mock掉config模块

不要让测试代码直接加载config的默认逻辑，自己mock一份配置：

// 在测试文件顶部或者jest.setup.js里
jest.mock('config', () => ({
  get: (key: string) => {
    // 返回你测试需要的配置值，比如数据库地址、端口等
    if (key === 'db.url') return 'mysql://localhost:3306/test';
    if (key === 'server.port') return 3000;
    return null;
  },
}));

方案2：让ts-jest处理config模块

如果必须用真实的config加载逻辑，就在jest配置里让ts-jest转译config模块，避免它的动态代码破坏source-map：

// jest.config.js里添加
transformIgnorePatterns: [
  '/node_modules/(?!config)/', // 不对config模块做转译忽略，让ts-jest处理它
],

第三步：其他排查小技巧 #

如果上面的方法都没用，可以试试这些：

• 运行测试时加--no-cache参数：npx jest --no-cache，强制Jest不使用缓存的source-map；
• 检查是否同时用了Babel和ts-jest：两者的source-map配置要一致，比如都用source-map类型，不要混用；
• 升级依赖版本：Jest 29.x对应的ts-jest版本最好是^29.1.0及以上，版本不兼容也会导致source-map解析错误；
• 用npx jest --showConfig查看最终生效的Jest配置，确认所有source-map相关选项都符合预期。

备注：内容来源于stack exchange，提问作者Alejandro Baranov