TypeScript扩展Express Request Body：如何声明req.body存在指定xxx属性

默认express.Request内置的body类型不包含业务自定义属性，直接访问req.body.xxx会触发TS类型不存在的报错，可根据实际场景选择以下任意一种方案实现类型识别。

方案1：单个路由按需扩展类型（推荐，影响范围最小） #

利用express.Request内置的泛型参数，单独为当前路由的请求指定body类型，不会影响其他路由的类型定义。
express.Request的泛型参数顺序为：路由参数类型, 响应体类型, 请求体类型, 查询参数类型，第三个参数就是请求体的类型定义位置。
示例代码：

// 1. 定义当前路由需要的请求体属性结构
interface RouteCustomBody {
  // 按实际需求定义xxx的类型，比如字符串、数字、嵌套接口等
  xxx: string;
  // 可同时定义其他需要的请求体属性，可选属性直接加?标记即可
}

// 2. 基于泛型扩展Request类型，指定body为自定义结构
type CustomRouteRequest = express.Request<{}, {}, RouteCustomBody>;

// 3. 替换原有路由函数的req类型声明
const fff = async (req: CustomRouteRequest, res: express.Response): Promise<void> => {
  // TS可正常识别req.body.xxx属性，无类型报错
  const value = req.body.xxx
}

方案2：全局扩展Express Request类型（适合全项目通用场景） #

如果全项目所有路由的请求体都包含公共的xxx属性，可通过TS模块声明合并的方式，全局扩展Express内置的Request接口。
在项目的类型声明文件（如types/express.d.ts）中写入：

declare global {
  namespace Express {
    interface Request {
      body: {
        xxx: string;
        // 其他全局通用的请求体属性
      }
    }
  }
}

配置完成后，所有路由的req.body.xxx都可被TS识别，无需单独为每个路由重复声明。

方案3：临时类型断言（仅适合调试场景，不推荐生产使用） #

临时绕过TS类型检查直接断言body结构，会丢失类型安全校验能力，仅适合临时调试快速验证逻辑：

const fff = async (req: express.Request, res: express.Response): Promise<void> => {
  // 强制将req.body断言为包含xxx属性的结构
  const value = (req.body as { xxx: string }).xxx
}

注意事项 #

• 确保tsconfig.json中开启strict: true配置，否则自定义类型的检查逻辑不会生效
• 不同路由的请求体结构差异较大时，优先选择方案1的按需扩展方式，避免全局定义的类型过于宽泛或不符合其他路由的实际业务结构，影响类型校验的准确性

内容的提问来源于stack exchange，提问作者T THE R