如何通过Node.js在Postman中返回自定义错误响应

核心问题原因 #

1. send.save()是异步操作，但未添加await，导致其抛出的错误无法被外层try/catch捕获，直接输出到终端
2. 即使捕获到错误，当前仅返回err.message，无法清晰展示Mongoose的字段级验证错误

解决方案代码修改 #

修正后的POST路由代码

router.post("/admin/add_profile", upload.single("image"), async (req, res) => {
  try {
    // 先校验文件是否上传
    if (!req.file) {
      return res.status(400).json({ 
        status: "error", 
        message: "图片文件为必填项" 
      });
    }

    const send = new SomeModel({
      first_name: req.body.first_name,
      last_name: req.body.last_name,
      phone: req.body.phone,
      email: req.body.email,
      image: req.file.filename,
    });

    // 等待save操作完成，捕获验证错误
    await send.save();

    // 注意：upload.single下文件存在req.file而非req.files，需调整为数组传入（适配s3Uploadv2参数）
    const result = await s3Uploadv2([req.file]);
    res.json({ status: "Everything worked as expected", result });
  } catch (err) {
    // 处理Mongoose字段验证错误
    if (err.name === "ValidationError") {
      const validationErrors = Object.values(err.errors).map(error => error.message);
      return res.status(400).json({ 
        status: "error", 
        message: "参数验证失败", 
        errors: validationErrors 
      });
    }
    // 处理唯一键重复错误（如phone/email重复）
    else if (err.code === 11000) {
      const duplicateField = Object.keys(err.keyPattern)[0];
      return res.status(400).json({ 
        status: "error", 
        message: `${duplicateField}已存在` 
      });
    }
    // 处理其他服务器错误
    res.status(500).json({ 
      status: "error", 
      message: err.message 
    });
  }
});

关键修改说明 #

• 添加await send.save()：让异步保存操作的错误进入try/catch块，从而能返回至Postman
• 针对性处理Mongoose错误：
  • 提取ValidationError中的字段错误信息，返回结构化的错误列表
  • 捕获唯一键冲突错误（错误码11000），返回明确的重复提示
• 修正文件参数：upload.single上传的文件存储在req.file，需转为数组传入s3Uploadv2（假设该函数接受文件数组）
• 规范HTTP状态码：用400表示请求参数错误，500表示服务器内部错误，更符合HTTP语义

内容的提问来源于stack exchange，提问作者sumanth.js