在Express.js与TypeScript中实现自定义Request对象的三种方式差异及选型咨询

嘿，我来帮你拆解这三种写法的核心差异，顺便打消你对第三种写法的顾虑——先给你吃个定心丸：第三种写法绝对不会把params、query等字段设置为undefined或null，完全不用担心！

1. 自定义继承Request的泛型接口（你的第一种写法） #

这种写法的思路很直接：通过继承Express原生的Request接口，只针对性重写body字段的类型，其他所有字段（比如params、query、headers）都完整保留原有的类型定义。

优点： #

• 类型安全拉满：编译阶段就会严格校验req.body的结构，一旦你访问不存在的字段（比如req.body.nickname），TypeScript立刻会报错
• 零侵入其他字段：params、query等依然保持Express默认的类型（比如ParamsDictionary、Query），完全不影响原有逻辑
• 复用性强：CustomRequest<T>可以在多个路由处理器里复用，只要传入不同的body类型就行

小缺点： #

需要额外定义一个泛型接口，多写几行代码而已，不算大问题

2. 使用as类型断言（你的第二种写法） #

先纠正个笔误：你代码里写的是res.body，应该是req.body对吧？这种写法和第一种的核心差异在于：

类型断言是你强行告诉TypeScript「我知道这个值的类型是什么，别管默认推断」，它本质是绕过TypeScript的类型检查，而不是真正定义类型。如果实际运行时req.body的结构和你断言的PersoneModel不一致，TypeScript不会在编译阶段提醒你，只会在运行时可能抛出错误。

举个例子：如果实际请求的body里没有email字段，第一种写法会直接在编译阶段提示req.body.email不存在，但用as断言的话，编译时毫无反应，运行时访问req.body.email会得到undefined，很容易引发后续bug。

总结： #

这种写法的类型安全性很低，除非你100%确定req.body的结构和断言类型完全匹配，否则不建议用。

3. 使用Express原生的Request泛型参数（你的第三种写法） #

这其实是Express官方推荐的写法！先给你解释下Express的Request泛型到底是怎么回事：

Express的Request接口本身就是泛型设计的，它的定义大概长这样：

interface Request<
  P = ParamsDictionary,  // params的类型，默认是键值对对象
  ResBody = any,         // 响应体的类型，默认any
  ReqBody = any,         // 请求体的类型，默认any
  ReqQuery = Query,      // query的类型，默认键值对对象
  Locals = Record<string, any>  // res.locals的类型
> {
  params: P;
  query: ReqQuery;
  body: ReqBody;
  // ...其他所有原生字段
}

你写的Request<{}, {}, ReqBodyInterface>，只是给ReqBody（请求体）指定了类型，前两个泛型参数用了默认值（第一个P传{}表示你当前路由没有URL参数，或者你不需要给params加类型校验）。

关键澄清： #

TypeScript的类型标注完全不会影响运行时的行为！也就是说，不管你给params指定什么类型，运行时req.params依然是Express解析后的正常对象，绝对不会变成undefined或null——你担心的情况根本不会发生。

如果你的路由有URL参数（比如/users/:id），你可以直接给第一个泛型参数传对应的接口：

interface UserParams {
  id: string;
}

export function UserDetailHandler(
  req: Request<UserParams, {}, ReqBodyInterface>,
  res: Response
){
  // req.params.id 会自动提示是string类型，编译时校验
  console.log(req.params.id);
}

优点： #

• 不用自定义额外接口，直接用官方规范，代码更简洁
• 可以同时给params、query、body甚至res.locals指定类型，灵活性拉满
• 完全符合Express的设计思路，后续维护起来更顺畅

三种写法对比&最终建议 #

如果你只是想给req.body指定类型，第三种写法是最优解，完全不用顾虑它会影响其他字段的运行时值。如果需要在多个地方复用包含自定义字段的Request结构，第一种写法更合适。尽量避免第二种as断言的写法，它太容易埋下运行时bug了。

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