TypeScript 2.8.3下扩展Express Request适配Passport user参数报错

你遇到的这个问题是TypeScript 2.8+版本类型检查严格化后，自定义继承Request的接口与Express官方RequestHandler类型不兼容导致的。下面是具体的解决方案和原因分析：

问题根源 #

你自定义的IRequest虽然继承了Request，但它是一个全新的接口类型。而Express的路由处理函数RequestHandler是基于官方原生Request接口定义的，TypeScript会认为你的回调函数参数类型（IRequest）和RequestHandler期望的Request类型不匹配，从而抛出类型错误。

正确解决方案：使用声明合并扩展Express Request接口 #

最优雅且符合TypeScript规范的方式是通过声明合并扩展Express的Request接口，这样全局的Request类型都会自动包含user属性，无需自定义新接口。

步骤1：创建类型声明文件 #

在项目中新建一个.d.ts类型声明文件（比如src/types/express.d.ts），内容如下：

import { User as CustomUser } from '../user'; // 调整路径到你的User类型文件

declare global {
  namespace Express {
    interface Request {
      user: CustomUser; // 添加你的user属性类型
    }
  }
}

步骤2：确保TypeScript识别该文件 #

检查tsconfig.json的include配置，确保包含了这个声明文件所在的目录，比如：

{
  "compilerOptions": {
    // 你的其他编译配置
  },
  "include": ["src/**/*"]
}

步骤3：在路由中直接使用原生Request类型 #

现在不需要自定义IRequest了，直接使用Express的Request类型即可，req.user会被自动识别为CustomUser类型：

import { Router, Request, Response } from 'express'
import { User as CustomUser } from './user'

const router: Router = Router()

router.get('/', requiresLogin, (req: Request, res: Response) => {
  console.log(req.user) // 此处不会报错，类型为CustomUser
  res.sendStatus(204)
})

备选方案：类型断言（不推荐） #

如果暂时不想使用声明合并，也可以通过类型断言绕过类型检查，但这种方式不够优雅，需要每次手动断言：

router.get('/', requiresLogin, (req: Request, res: Response) => {
  const user = req.user as CustomUser;
  console.log(user)
  res.sendStatus(204)
})

为什么旧版本没问题？ #

TypeScript 2.8之前的类型检查相对宽松，对于结构兼容的类型会默认允许赋值。但2.8+版本加强了类型系统的严格性，尤其是接口继承和类型兼容性的判断逻辑，所以之前的写法现在会触发错误。

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