无法扩展Express Request接口/类型：自定义接口注解报错求助

报错原因 #

你直接定义了一个独立的Request接口并继承Express原生Request，但TypeScript并未将这个自定义接口与Express的内置类型关联。Express路由处理器期望接收原生Express.Request类型参数，而你的自定义接口被视为完全独立的类型，因此触发类型不匹配错误。

解决方案 #

1. 通过模块扩展修改Express原生Request类型

不要创建新接口，而是利用TypeScript的全局模块扩展功能，直接给Express的Request类型添加属性。

在项目中创建types/express/index.d.ts文件（目录可自定义，确保TypeScript能扫描到）：

import { User } from "@prisma/client";

declare global {
  namespace Express {
    interface Request {
      id: string;
      user: User;
    }
  }
}

此操作会让TypeScript全局识别到Express的Request类型新增了id和user属性。

2. 修正控制器中的类型引用

无需再导入自定义的Request接口，直接使用Express原生的Request即可，它已经包含你扩展的属性：

import { Request, Response } from "express";

const loginHandler = async (request: Request, response: Response) => {
  // 此时可正常访问 request.id 和 request.user，类型校验完全通过
};

export default loginHandler;

3. 确保TypeScript配置正确

在tsconfig.json中，确认typeRoots包含自定义类型目录，让TypeScript加载我们的扩展定义：

{
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "./types"]
  }
}

原理说明 #

直接继承创建新接口的方式，相当于定义了一个与Express原生Request平行的类型，二者在TypeScript类型系统中不互通。而通过全局模块扩展，我们直接修改了Express内置的Request类型，所有使用Express.Request的场景都会自动包含扩展属性，自然满足路由处理器的类型要求。

内容的提问来源于stack exchange，提问作者Mustafa Ahmed Mohammed