如何正确导入express-request-id扩展的Request类型？

核心原因与解决步骤 #

1. 确认类型依赖安装 #

如果express-request-id未内置类型定义，需先安装对应的类型包：

npm install @types/express-request-id --save-dev

若包本身自带类型文件，可跳过此步骤。

2. 让TypeScript自动识别类型扩展 #

express-request-id的类型定义是通过模块扩展机制增强Express原生Request接口的，不需要手动导入扩展后的Request类型，只需确保TypeScript能扫描到该类型文件。

检查tsconfig.json的include配置，确保包含类型文件目录：

{
  "compilerOptions": {
    // 其他编译配置
  },
  "include": [
    "src/**/*",
    "node_modules/@types/**/*.d.ts"
  ]
}

3. 手动导入类型文件（自动识别失效时） #

若TypeScript仍未识别到扩展，可在项目的自定义类型文件（如src/types/index.d.ts）中手动导入该包的类型：

import 'express-request-id';

此时Request接口会自动继承id属性。

4. 修正中间件代码（附带问题修复） #

原中间件存在请求挂起的问题，需补充调用next()，修正后代码无需修改Request导入即可正常使用：

import type { Request, NextFunction, Response } from 'express';

export const requestIdHandler = () => (req: Request, res: Response, next: NextFunction) => {
    res.set('X-Request-Id', req.id);
    next();
};

内容的提问来源于stack exchange，提问作者Hermann.Gruber