Node.js Express中间体验证失效及返回类型设置咨询

一、验证失效的核心原因 #

你代码里的switch用法完全错误：switch(data)是拿data对象和每个case后的布尔值（比如!data.name）做全等比较，对象与布尔值永远不可能相等，导致所有case都不匹配，直接走到default执行next()，验证逻辑完全失效。

二、修复后的中间件代码 #

推荐用遍历必填字段数组的方式实现，更简洁易维护：

import { IMiddlewaresRules } from "../IMiddlewaresRules";
import { Request, Response, NextFunction } from "express";

// 定义请求体data字段的TypeScript类型
interface FigureRequestBodyData {
  name: string;
  category: string;
  price: string;
  specifications: string;
  releaseInfo: string;
  serieID: number;
  manufacturerID: number;
  details?: string; // 可选字段
}

// 扩展Express Request类型，让req.body拥有明确类型
declare global {
  namespace Express {
    interface Request {
      body: {
        data: FigureRequestBodyData;
      };
    }
  }
}

export class VerifyRequestsBody implements IMiddlewaresRules {
  verifyBodyFigure(
    req: Request,
    res: Response,
    next: NextFunction
  ): Response | void { // 明确返回类型：验证失败返回Response，成功无返回（执行next）
    const data = req.body.data;
    if (!data) {
      return res.status(400).json({ message: "Missing data field" });
    }

    // 定义必填字段与对应错误提示的映射
    const requiredFields: Array<[keyof FigureRequestBodyData, string]> = [
      ["name", "Missing name"],
      ["category", "Missing category"],
      ["price", "Missing price"],
      ["specifications", "Missing specifications"],
      ["releaseInfo", "Missing releaseInfo"],
      ["serieID", "Missing serieID"],
      ["manufacturerID", "Missing manufacturerID"],
    ];

    // 遍历检查所有必填字段
    for (const [field, message] of requiredFields) {
      if (!data[field]) {
        return res.status(400).json({ message });
      }
    }

    // 验证通过，进入下一个中间件
    next();
  }
}

三、TypeScript类型设置说明 #

1. 请求体类型约束：

   • 定义FigureRequestBodyData接口，明确data字段的必填/可选属性，编译阶段就能检查字段类型和拼写错误。
   • 通过declare global扩展Express的Request接口，让req.body.data获得类型提示，避免使用any类型。

2. 中间件返回值类型：

   • 方法返回类型设为Response | void：验证失败时返回Response对象，验证成功时调用next()（无返回值，对应void），完全覆盖所有分支的返回情况，消除类型模糊。

3. 必填字段列表类型：

   • 使用Array<[keyof FigureRequestBodyData, string]>确保字段名必须是FigureRequestBodyData中存在的属性，避免手动拼写错误，提升代码健壮性。

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