TypeScript项目ts-node启动时触发Jest的beforeAll未定义报错

• tsconfig.json的exclude字段仅对tsc全量编译流程生效，作用是筛选编译范围，完全不会约束ts-node运行时的文件加载逻辑，也不会干预框架层面的文件系统通配符扫描行为
• 项目采用测试文件与业务代码同目录的结构，TypeORM、TypeGraphQL等框架如果用了宽匹配的通配符（比如直接扫./src/**/*.ts），会把同目录下的*.test.ts、*.spec.ts文件一并加载到运行环境里
• Jest跑测试的时候会全局注入所有匹配的API（beforeAll/describe/afterAll等），就算测试文件被加载也不会报错，但服务启动的运行环境没有这些全局方法，测试文件被加载执行时找不到对应API，自然就触发ReferenceError报错
• 之前的配置只是给tsc加了测试文件排除规则，没针对ts-node运行时、框架扫描规则做适配，所以根本挡不住测试文件被误加载

1. 调整框架通配符扫描的匹配规则 #

在所有涉及文件路径通配加载的配置中，显式排除测试类文件，避免被误扫描。大部分基于glob规则的文件扫描工具都支持取反排除的写法：

• TypeORM的entities/subscribers/migrations配置：将原有的宽路径匹配替换为带排除规则的glob表达式，例如：

  // 错误写法：匹配目录下所有ts文件，会带入测试文件
  entities: ["./src/**/*.ts"]
  
  // 修正写法：优先匹配符合业务命名规则的文件，同时显式排除测试文件
  entities: [
    "./src/**/*.entity.ts",
    "!./src/**/*.test.ts",
    "!./src/**/*.spec.ts"
  ]
  

• TypeGraphQL的resolvers配置：同样按上述规则调整通配符匹配范围，不要使用全目录全文件的宽匹配

2. 给ts-node添加专属的文件加载过滤规则 #

ts-node有独立于tsc的文件加载逻辑，需要在tsconfig.json中新增ts-node专属配置段，明确要求ts-node跳过测试文件的编译与加载：

{
  "ts-node": {
    "transpileOnly": true,
    "ignore": [
      "(.*)\\.test\\.ts$",
      "(.*)\\.spec\\.ts$"
    ],
    "compilerOptions": {
      "module": "commonjs"
    }
  }
}

配置生效后，ts-node在运行时遇到.test.ts、.spec.ts后缀的文件会直接跳过，不会读取文件内容执行代码

3. 验证运行时加载链路 #

调整配置后重启服务，可通过在框架的文件加载逻辑中添加日志，确认扫描到的文件列表不再包含测试类文件，从根源上避免测试代码进入服务运行时上下文。

• 别指望靠tsconfig通用的exclude字段做运行时的测试文件过滤，这个字段只在跑tsc编译的时候有用，运行时加载逻辑根本不读这个规则
• 保持Jest配置的testMatch规则仅指向*.test.ts、*.spec.ts文件，别改的太宽把业务代码当成测试文件扫了
• 后续新增测试文件统一用.test.ts/.spec.ts后缀，确保现有的过滤规则能正常覆盖

内容的提问来源于stack exchange，提问作者Alec Bellinghausen Pagliarussi