Node.js Express TypeScript中如何使req.body可选字段类型为string|undefined？

1. 检查TypeScript严格空值检查配置 #

先确认tsconfig.json中是否开启了strictNullChecks：

{
  "compilerOptions": {
    "strictNullChecks": true,
    // 其他编译配置...
  }
}

如果该选项为false，TypeScript会自动忽略undefined类型，导致可选字段被推断为非可选的string。开启后，可选字段的类型会正确识别为string | undefined。

2. 显式约束body类型（若配置已正确） #

若已开启严格检查但类型仍不符合预期，可以显式将req.body断言为你定义的body类型：

import type { Request } from 'express';

// 单独定义body类型，提升可读性
export type TGetItemsControllerRequestBody = {
  page: number;
  limit: number;
  searchQuery?: string;
};

export type TGetItemsControllerRequest = Request<unknown, unknown, TGetItemsControllerRequestBody>;

export const getItemsController = async (
  req: TGetItemsControllerRequest,
  res: TGetItemsControllerResponse,
) => {
  const body = req.body as TGetItemsControllerRequestBody;
  const { limit, page, searchQuery } = body;
  // 此时searchQuery类型为string | undefined
  ...
};

3. 用可选链操作符辅助类型推断 #

如果需要在代码中安全处理字段，可结合可选链操作符，让TypeScript自动推断正确类型：

const searchQuery = req.body?.searchQuery;

这种写法会直接让searchQuery的类型被识别为string | undefined。

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