Node.js请求校验失效致服务器崩溃，求排查与解决建议

崩溃原因 #

你的服务器崩溃核心是校验逻辑没有终止函数执行：比如当name为空时，你返回了400响应，但代码没有停止，依然会执行到创建Car实例并调用save方法。这会触发两个致命问题：

• 空字段传入数据库触发约束错误
• 已经发送过一次HTTP响应（res.send），后续又尝试发送res.json，Express会抛出Cannot set headers after they are sent to the client错误，直接导致服务器崩溃。

解决建议 #

1. 紧急修复：给校验分支添加终止逻辑

在每个校验的res.send后加上return，确保校验不通过时立刻停止后续代码执行：

// create new car
export async function createCar (req, res) {
   // 先校验请求体是否存在
   if (!req.body) {
     return res.status(400).send({ message: "请求体不能为空！" });
   }

   // 校验字段，每个分支都加return终止执行
    if (!req.body.name) {
        return res.status(400).send({
          message: "Name can not be empty!"
        });
    } 
    if (!req.body.color){
        return res.status(400).send({
            message: "Color can not be empty!"
        });
    } 
    if (!req.body.brand) {
        return res.status(400).send({
            message: "Brand can not be empty!"
        });
    }

    // 注意：这里的id需要确保已正确定义，否则会触发新错误
    const car = new Car({
      car_id: id,
      name: req.body.name,
      color: req.body.color,
      brand: req.body.brand,
    });
    
    return car
      .save()
      .then((newCar) => {
        return res.status(201).json({
          success: true,
          message: 'New car created successfully',
          Car: newCar,
        });
      })
      .catch((error) => {
          console.log(error);
        return res.status(500).json({
          success: false,
          message: 'Server error. Please try again.',
          error: error.message,
        });
      });
  }

2. 体验优化：一次性返回所有错误

如果想让用户一次知晓所有缺失字段，可以收集错误信息后统一返回：

export async function createCar (req, res) {
  if (!req.body) {
    return res.status(400).send({ message: "请求体不能为空！" });
  }

  const errors = [];
  if (!req.body.name) errors.push("Name can not be empty!");
  if (!req.body.color) errors.push("Color can not be empty!");
  if (!req.body.brand) errors.push("Brand can not be empty!");

  if (errors.length > 0) {
    return res.status(400).send({
      message: "校验失败",
      errors: errors
    });
  }

  // 后续创建和保存逻辑不变...
}

3. 长期方案：使用专业校验库

对于复杂校验场景，推荐用Joi或Zod这类库，简化代码同时支持更复杂的规则（比如格式、长度限制）：
以Zod为例：

import { z } from "zod";

// 定义校验规则
const CarSchema = z.object({
  name: z.string().nonempty("Name can not be empty!"),
  color: z.string().nonempty("Color can not be empty!"),
  brand: z.string().nonempty("Brand can not be empty!")
});

export async function createCar (req, res) {
  try {
    // 校验请求体，失败直接抛出错误
    const validatedData = CarSchema.parse(req.body);

    const car = new Car({
      car_id: id,
      ...validatedData
    });

    const newCar = await car.save();
    return res.status(201).json({
      success: true,
      message: 'New car created successfully',
      Car: newCar,
    });
  } catch (error) {
    if (error instanceof z.ZodError) {
      // 处理校验错误
      return res.status(400).json({
        success: false,
        message: "校验失败",
        errors: error.errors.map(err => err.message)
      });
    } else {
      // 处理数据库或其他服务器错误
      console.log(error);
      return res.status(500).json({
        success: false,
        message: 'Server error. Please try again.',
        error: error.message,
      });
    }
  }
}

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