使用typeRoots扩展Express Request类型仍报TS2339错误如何解决

报错核心原因 #

完成类型声明配置后依然报错，本质是自定义的Express类型扩展没有被TypeScript正确识别，通常由两个问题导致：

• 类型声明文件存在顶层import语法，导致文件被识别为独立ES模块而非全局类型声明文件，内部声明的Express.Request扩展不会自动合并到全局类型
• tsconfig配置的扫描路径未覆盖自定义类型文件目录，或TS服务缓存未刷新

修复步骤 #

1. 修正类型声明文件写法 #

打开/src/custom_typings/express.d.ts，替换为以下内容：

declare global {
  namespace Express {
    interface Request {
      dataSource: import("typeorm").DataSource;
    }
  }
}

// 空导出标记文件为合法模块，消除TS冗余校验报错
export {};

原理：只要文件顶层存在import/export关键字，TS就会将其判定为模块，模块内的类型声明默认是模块作用域，必须包裹在declare global块内才能合并到全局类型。这里用动态导入import("typeorm")引入类型，避免顶层import破坏作用域。

2. 校验tsconfig配置 #

确保tsconfig.json的include配置覆盖到自定义类型文件所在目录，参考配置如下：

{
  "compilerOptions": {
    "typeRoots": [
      "./src/custom_typings",
      "./node_modules/@types"
    ]
    // 其余编译选项保持原有配置即可
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

注意：typeRoots数组最后一项不要加多余尾逗号，低版本TypeScript会因JSON格式解析错误忽略该配置。

3. 刷新TS类型缓存 #

在VS Code中按下快捷键Ctrl+Shift+P（Mac系统为Cmd+Shift+P），调出命令面板后执行TypeScript: Restart TS Server，等待TS服务重启完成即可。

验证 #

配置生效后，在中间件或路由处理函数中访问req.dataSource时，TS会自动提示DataSource的内置方法和属性，不再抛出Property 'dataSource' does not exist的2339报错。

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