REST服务中如何正确校验请求并返回错误？含数据库约束校验场景

客户端向服务器发送请求，例如POST /companies，请求体格式如下：

{
  "name": String (unique),
  "ownerId": Long (fk)
}

我在校验请求时，首先检查name字段是否为指定长度的字符串，以及ownerId是否为数字。若存在错误，会返回包含错误列表的400响应。但关于name字段的唯一性校验和ownerId对应的ID存在性校验，我是否应将这些数据库约束错误也纳入校验错误列表（与所有错误放在一起）？是否应将唯一性错误（数据库约束错误）和格式错误（DTO错误）放在同一个列表中返回？例如：

{
  "errors": [
    {
      "field": "name",
      "error": "该名称已存在！"
    }, 
    {
      "field": "ownerId",
      "error": "格式错误，ownerId必须为数字！"
    }
  ]
}

结论与分析 #

完全可以（甚至推荐）把数据库约束错误和DTO格式错误放在同一个错误列表里返回，理由如下：

• 对客户端更友好：客户端只需要处理一种统一的错误响应格式，不用额外区分错误来源是内存校验还是数据库约束，前端可以直接把所有错误对应到表单字段上展示，降低对接复杂度。
• 符合HTTP语义：不管是格式错误还是业务约束（唯一性、外键存在性）不满足，本质都是请求本身不符合服务端的要求，返回400 Bad Request完全合理，不需要用其他状态码区分。
• 实现上的注意事项：
  • 要捕获数据库的唯一键冲突、外键不存在异常，将其转换为和DTO错误一致的格式返回，绝对不能把数据库原生的错误信息直接抛给客户端，避免泄露系统细节。
  • 建议先在业务层做一次预校验（比如先查数据库确认name未被占用、ownerId存在），减少直接触发数据库异常的情况，既提升性能也能更精准控制错误文案；但并发场景下预校验可能存在竞态问题，这时候必须捕获数据库异常作为兜底方案。

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