表单验证与错误处理

这一课你将能做到

1. 在控制器中用 validate() 快速校验输入，并读懂自动返回的 422 与错误包
2. 用 FormRequest 类把规则、授权、错误消息集中管理，并处理嵌套数组与文件校验
3. 编写自定义验证规则，学会用 Rule 对象表达唯一值、存在性、枚举等复杂约束

为什么要学

「永远不要信任客户端输入」是后端第一课。Spring Boot 里你用 Bean Validation（@NotBlank、@Min、@Valid），由 Hibernate Validator 执行，失败后在 BindingResult 或全局异常里处理。Laravel 的验证层覆盖同样的场景，但规则以数组或字符串表达，开箱即用近百条规则，且能自动生成字段级错误消息——中文提示也只需发布语言文件。

验证还有两个工程价值：它与授权（FormRequest 的 authorize()）、旧输入回填（old()）无缝衔接；它是异常 API 统一响应的第一个真实案例。本课把「下单」接口的规则完整写透。

先建立图像

请求进入
   │
   ▼
FormRequest::authorize()  ──false──► 403
   │true
   ▼
rules() 逐条校验
   │全部通过      └──► 控制器方法内 $request->validated() 只拿干净数据
   ▼
ValidationException（422）
   ├─ web：back() + errors + old 输入（Blade @error 回显）
   └─ api：{ message, errors: { field: [msgs...] } } JSON

规则对照：

Laravel	Bean Validation
required	@NotNull / @NotBlank
string / integer / numeric	类型绑定 + @Pattern
min:3 / max:20（字符串看长度，数字看大小）	@Size / @Min/@Max
email	@Email
unique:users,email	需手写查询校验
exists:orders,id	需手写
confirmed（需有 xxx_confirmation 字段）	手写两次比对
in:a,b / 枚举 Rule	@Pattern 或自定义

跟着做

步骤 1：控制器内快速验证

<?php

namespace App\Http\Controllers\Api;

use App\Http\Controllers\Controller;
use Illuminate\Http\Request;

class OrderController extends Controller
{
    public function store(Request $request)
    {
        $validated = $request->validate([
            'channel'          => ['required', 'string', 'in:alipay,wechat,mock'],
            'address_id'       => ['required', 'integer', 'exists:addresses,id'],
            'remark'           => ['nullable', 'string', 'max:200'],
            'items'            => ['required', 'array', 'min:1'],
            'items.*.product_id' => ['required', 'integer', 'exists:products,id'],
            'items.*.quantity'   => ['required', 'integer', 'min:1', 'max:99'],
            'coupon_code'      => ['nullable', 'string', 'size:8'],
        ]);

        // 只有通过校验的字段会出现在这里
        return response()->json(['received' => $validated], 201);
    }
}