Laravel中$validator->validated()验证数组未抛出异常问题咨询

安全阿岳

2026-7-1

Laravel自定义数组验证规则不触发validated()异常的问题

你遇到的问题确实是Laravel框架处理数组字段自定义验证规则时的逻辑缺陷，并非你遗漏了配置或用法。

问题根源

调用$validator->validated()时，内部会执行invalid()方法，其中这行代码导致验证错误丢失：

$failed = Arr::only(Arr::dot($invalid), array_keys($this->failed()));

$this->failed()里记录的是你定义的原字段名（比如environments）
Arr::dot($invalid)会把数组字段的错误扁平化，生成environments.0、environments.1这类带索引的键
最终Arr::only无法匹配到原字段名对应的错误，导致$failed为空，框架误判为没有验证失败，因此不抛出ValidationException

解决办法

有两种实用的解决方式：

1. 手动校验并抛出异常

不依赖validated()的自动异常抛出，改为手动判断后抛出：

$validator = Validator::make($data, $rules);

if ($validator->fails()) {
    throw $validator->exception();
}

$validatedData = $validator->validated();

这种方式最直接，能确保所有验证错误都被正确捕获并抛出异常。

2. 修改自定义规则，绑定错误到数组元素

如果想保留validated()的自动抛出逻辑，可以修改自定义规则的错误提示，将错误关联到数组的具体索引：

public function validate(string $attribute, mixed $value, Closure $fail): void
{
    foreach ($value as $index => $item) {
        if (strtoupper($item) !== $item) {
            $fail("The {$attribute}.{$index} must be uppercase.");
        }
    }
}

这样$this->failed()中会记录environments.0这类带索引的字段名，和Arr::dot($invalid)后的键匹配，validated()就能正常触发异常。不过这种方式的错误提示会针对每个数组元素，而非整个数组字段。