扩展Express.Request类型时无法访问headers属性的问题排查

你确实应该基于Express.Request来扩展类型，但报错的原因是接口继承的类型合并机制没有正确包含所有扩展属性（包括Passport添加的），同时你用query: T覆盖原类型的query字段后，TypeScript没能正确关联到Request的其他原有属性。

为什么会出现属性缺失？ #

1. Express的Request类型本身包含headers等属性，但自定义接口继承并覆盖query字段时，如果类型定义文件没和Express、Passport的全局类型正确合并，TypeScript就无法识别这些原有属性。
2. Passport是通过声明合并扩展Express.Request的（比如添加user属性），自定义接口继承如果不在正确作用域下，无法自动包含这些扩展属性。

修复方案 #

最稳妥的方式是用**类型交叉（Intersection Types）**替代接口继承，既能保留Express.Request的所有原有属性（包括Passport扩展的），又能精准定义query的类型：

// 替换原接口定义为类型交叉
export type TypedRequestQuery<T> = Express.Request & { query: T };

使用示例 #

router.get("/", async (req: TypedRequestQuery<{ data: string }>, res) => {
  // query类型精准提示
  console.log(req.query.data);
  // headers等原有属性正常识别
  console.log(req.headers["x-forwarded-for"]);
  // Passport扩展的user属性也能正常访问（如果已配置）
  console.log(req.user);
});

为什么交叉类型更有效？ #

• 接口继承在覆盖同名属性时，TypeScript的类型合并逻辑可能忽略原类型的部分关联属性；而交叉类型会直接合并两个类型的所有属性，且后面的类型会覆盖前面的同名属性（这里{ query: T }会覆盖Express.Request原有的query类型）。
• 交叉类型自动兼容第三方库对Express.Request的扩展（比如Passport的user），无需额外配置。

额外检查项 #

1. 确保已安装正确的类型依赖：

npm install @types/express @types/passport --save-dev

2. 检查tsconfig.json中是否启用相关配置，确保TypeScript能找到这些类型文件：

{
  "compilerOptions": {
    "types": ["express", "passport"]
  }
}

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