TypeScript moduleResolution node16/node10与express-request-id类型引用问题

核心原因 #

当moduleResolution设为node16或nodenext时，TypeScript采用了更严格的模块解析规则，完全对齐ECMAScript模块(ESM)和CommonJS(CJS)的差异，而express-request-id包的类型定义文件types.d.ts未适配这种新规则：

• 包的package.json中types字段配置缺失或路径不符合新解析要求
• 类型文件的导出方式未遵循ESM/CJS的明确规范，比如缺少export声明，或全局类型未正确声明
• 新解析模式下，CJS模块的类型引用需要更明确的路径标识，旧模式下的隐式路径映射不再生效

可行解决方案 #

1. 调整项目TypeScript配置 #

在项目的tsconfig.json中添加路径映射，手动指定类型文件的位置：

{
  "compilerOptions": {
    "paths": {
      "express-request-id": ["./node_modules/express-request-id/types.d.ts"]
    }
  }
}

或者扩展typeRoots，让TypeScript能搜索到该包的类型文件：

{
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "./node_modules/express-request-id"]
  }
}

2. 手动导入类型文件 #

在需要使用该包类型的文件中，直接导入types.d.ts：

import type { RequestIdOptions } from '../node_modules/express-request-id/types.d.ts';

3. 修复包的类型配置（若可修改包） #

如果能fork或修改express-request-id包的配置：

• 在包的package.json中确保types字段正确指向类型文件：

  "types": "./types.d.ts"
  

• 若包为CJS类型，在package.json中添加"type": "commonjs"，确保类型解析符合CJS规则

4. 向包维护者提交适配请求 #

如果上述临时方案无法满足需求，建议在express-request-id的仓库提交Issue，要求维护者适配node16/nodenext的模块解析模式。

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