Laravel嵌套数组验证需严格匹配结构：固定字段用'key.subkey.field'，动态数组用'key.*.field'，Rule::forEach闭包参数为($value,$key)，条件规则不支持跨层，前后端数组形态必须一致。
在 Laravel 11 中，对嵌套数组字段（例如 user.profile.name、items.0.price 或 tags.*.id）进行验证，核心是正确使用点号（.）和通配符（*）来声明规则键名，并配合 Laravel 内置的数组验证规则（如 required_array、array、required_if 等）以及针对子项的嵌套规则。
基础嵌套数组字段规则写法
Laravel 将请求数据视为扁平化结构，所以即使前端传的是多维数组，验证器也通过点号路径访问。例如：
-
items是一个数组 → 规则写'items' => 'required|array' -
items.0.name是第一个元素的 name 字段 → 规则写'items.*.name' => 'required|string|max:50' -
items.0.tags是一个子数组 → 先确保它是数组：'items.*.tags' => 'required|array'，再校验其子项：'items.*.tags.*.id' => 'required|integer|exists:tags,id'
常用嵌套场景与规则示例
场景 1：可选的嵌套对象（如 user.profile）
假设请求体含：{"user": {"name": "Tom", "profile": {"age": 25, "city": "Beijing"}}
'user.profile.age' => 'nullable|integer|min:0|max:120', 'user.profile.city' => 'nullable|string|max:100'
注意：nullable 允许 profile 为 null 或缺失；若要求 profile 必须存在且为数组，则加：'user.profile' => 'required|array'
场景 2：索引数组（如 items[0][price]）
前端发送：items[0][name]=Book&items[0][price]=29.99&items[1][name]=Pen
'items' => 'required|array|min:1', 'items.*.name' => 'required|string', 'items.*.price' => 'required|numeric|min:0.01', 'items.*.price' => 'required_if:items.*.name,Book|numeric' // 条件校验示例
⚠️ 注意：required_if 在嵌套中需谨慎使用——它只作用于当前匹配的索引项，Laravel 会自动绑定上下文（即 items.0.name 和 items.0.price 关联）
场景 3：关联 ID 数组（如 role_permissions[role_id][] = permission_id）
请求形如：role_permissions[1][]=101&role_permissions[1][]=102&role_permissions[2][]=101
'role_permissions' => 'required|array', 'role_permissions.*' => 'required|array', // 每个 role_id 下必须是数组 'role_permissions.*.*' => 'required|integer|exists:permissions,id',
这里 role_permissions.*.* 表示任意 role_id 下的任意元素，都需是存在的 permission ID
进阶技巧：自定义嵌套验证消息与条件逻辑
默认错误消息键名为 items.0.name，但可自定义更友好的提示：
public function messages()
{
return [
'items.*.name.required' => '每项商品必须填写名称',
'items.*.price.numeric' => '商品价格必须是数字',
];
}
也可用闭包规则实现动态逻辑，例如限制每个 item 最多 3 个 tag：
'items.*.tags' => [
'required',
'array',
function ($attribute, $value, $fail) {
if (count($value) > 3) {
$fail(':attribute 最多只能有 3 个标签');
}
}
],
注意事项与避坑点
- 不要写
'items.*' => 'array'来试图验证整个子数组结构 —— 这只会校验items的每个值是否为数组，而非其内部字段；应明确写出子字段路径 - 当字段可能完全缺失（如没传
profile），用nullable+required_if或先校验父级是否存在（如'user.profile' => 'sometimes|array'） - Laravel 11 默认启用严格模式，空字符串
''不等价于null，必要时加filled或string配合nullable - 批量验证失败时，错误 key 会是
items.0.name形式，前端可据此精准定位错误项
