Express中间件单独传递与数组形式传递的差异及类型推断异常问题咨询

你好，我刚好碰到过类似的问题，咱们来拆解一下这个类型推断失效的核心原因：

首先明确你的问题场景：使用zod-express-middleware做请求参数校验时，单独传递中间件的情况下，请求处理器里的req.body能被正确推断出你定义的Zod Schema类型；但把任意中间件放进数组里传递时，req.body的类型就丢失了，回到了默认的any或者Express基础Body类型。

先把你的关键代码示例整理出来方便对照：

正常工作的写法（单独传中间件） #

// router.ts
myRouter.post("/",
  myMiddleware,
  validateRequest({ body: RequestBody }),
  async (req, res) => {
    const { one, two } = req.body // 这里one和two的类型被正确推断为string和number
    console.log(one, two)
    res.sendStatus(200)
  }
)

类型推断失效的三种数组写法 #

写法1：部分中间件放数组

myRouter.post("/",
  [myMiddleware], // 把中间件放进数组
  validateRequest({ body: RequestBody }),
  async (req, res) => {
    const { one, two } = req.body // 类型丢失！
    console.log(one, two)
    res.sendStatus(200)
  }
)

写法2：所有中间件放数组

myRouter.post("/",
  [
    myMiddleware,
    validateRequest({ body: RequestBody })
  ], // 所有中间件都在数组里
  async (req, res) => {
    const { one, two } = req.body // 类型丢失！
    console.log(one, two)
    res.sendStatus(200)
  }
)

写法3：连请求处理器也放进数组

myRouter.post("/",
  [
    myMiddleware,
    validateRequest({ body: RequestBody }),
    async (req, res) => {
      const { one, two } = req.body // 类型丢失！
      console.log(one, two)
      res.sendStatus(200)
    }
  ]
)

核心原因：Express类型定义的重载差异 + TypeScript数组类型限制 #

问题的根源不在zod-express-middleware本身，而是Express的类型定义（@types/express）对路由方法的参数重载设计，以及TypeScript对数组类型的推断限制：

1. 单独传递中间件时的类型处理：
   Express的Router.post等方法有多个重载，当你逐个传递中间件时，每个中间件的类型会被TypeScript依次处理。zod-express-middleware的validateRequest函数返回的是一个带有泛型的RequestHandler，这个泛型会告诉TypeScript：“处理完这个中间件后，req的body应该符合我定义的Zod Schema”。TypeScript能正确识别这个泛型，并将类型增强应用到后续的req对象上。

2. 数组形式传递时的类型处理：
   当你把中间件放进数组时，Express的类型定义会把这个数组解析为express.RequestHandler[]——这是一个无泛型的、统一的数组类型。TypeScript无法从这个数组里的每个元素中提取出单独的泛型信息，也就无法把validateRequest带来的类型增强应用到后续的req对象上。简单说，数组“抹平”了中间件的类型细节，导致Zod的类型推断失效。

验证思路 #

你可以去查看@types/express里的Router类型定义，会发现它的路由方法（比如post）有两种主要重载：

• 一种是接收多个RequestHandler参数（对应逐个传递的情况）
• 一种是接收RequestHandler[]数组参数（对应数组传递的情况）

而zod-express-middleware的类型增强是依赖第一种重载的“逐次类型合并”机制的，数组形式的重载不支持这种类型合并，所以就出现了类型丢失的问题。

临时解决方案 #

如果必须用数组形式组织中间件，你可以手动给req参数指定类型：

// 先从Zod Schema提取类型
type RequestBodyType = z.infer<typeof RequestBody>

async (req: express.Request<{}, {}, RequestBodyType>, res) => {
  const { one, two } = req.body // 类型恢复正常
  console.log(one, two)
  res.sendStatus(200)
}

当然，这只是权宜之计，最好还是尽量用单独传递的方式来保留自动类型推断的能力。

备注：内容来源于stack exchange，提问作者zaplec