Laravel POST错误返回应统一格式、明确字段、提供可操作提示：用validate()自动返回422结构化错误，手动返回时保持{"field":["msg"]}格式，添加code字段便于前端分流处理，并按语义使用HTTP状态码。
在 Laravel 中，POST 请求返回自定义错误时，关键不是“怎么抛异常”，而是“怎么让前端看得懂、改得快、不懵”。核心是统一格式 + 明确字段 + 可操作提示。
用 validate() 方法自动返回结构化错误
Laravel 的表单验证器会自动把失败的验证规则转成标准 JSON 错误响应（status 422），字段名和提示一一对应，前端可直接解构使用：
- 控制器里直接调用 $request->validate([...])，不用手动写 if 判断
- 自定义提示写在 rules 数组后第二个参数，比如：'email.required' => '邮箱不能为空'
- 错误结构默认是 {"email": ["邮箱不能为空"]}，前端用
errors.email[0]就能取到第一条提示
手动返回错误时保持和 validate 一致的格式
有些逻辑无法用 validate 覆盖（比如检查用户是否已存在、库存不足等），这时用 response()->json() 手动返回，但结构要对齐：
- 不要只返回
{"message": "用户名已存在"}—— 前端难定位是哪个字段出问题 - 推荐格式：
{"username": ["用户名已被占用"]}，和 validate 输出完全一样 - 如果涉及多个字段或无字段关联的全局错误，可用
{"error": ["支付超时，请重试"]}，但尽量少用
给错误加语义化 code，方便前端分流处理
纯 message 不够，加一个 code 字段 告诉前端这是啥类型错误：
- 例如：
{"username": ["用户名已被占用"], "code": "user_exists"} - 前端可基于 code 做特定交互：code 是 "insufficient_stock" 就弹库存提醒；是 "rate_limit" 就禁用按钮倒计时
- code 建议用小写字母+下划线，避免魔法字符串，统一定义在 config/error_codes.php 里
别忽略 HTTP 状态码的语义
422 是验证失败的标准码，但其他场景要换：
- 数据不存在 → 404（如 POST /orders 时传了无效 address_id）
- 权限不足 → 403（如普通用户尝试创建管理员）
- 业务冲突（如重复提交）→ 409（Conflict）
- 服务器内部问题 → 500 或更具体的 503（服务暂时不可用）
