Laravel数组规则验证错误消息未提示非法键，如何优化？

当使用array:something,another规则校验数组键白名单时，Laravel默认的错误消息无法提示具体非法键名。以下两种方法可以实现自定义错误提示，明确告知用户哪个键不合法：

方法一：在FormRequest中手动校验非法键 #

在你的FormRequest类中重写withValidator方法，通过after回调手动检查数组键是否在白名单内，发现非法键时添加自定义错误：

use Illuminate\Validation\Validator;

class YourFormRequest extends FormRequest
{
    // 原有校验规则
    public function rules()
    {
        return [
            'example' => ['array:something,another'],
        ];
    }

    // 自定义校验逻辑
    public function withValidator(Validator $validator)
    {
        $validator->after(function ($validator) {
            $exampleData = $this->input('example');
            
            if (is_array($exampleData)) {
                $allowedKeys = ['something', 'another'];
                $invalidKeys = array_diff(array_keys($exampleData), $allowedKeys);
                
                // 为每个非法键添加错误提示
                foreach ($invalidKeys as $key) {
                    $validator->errors()->add(
                        'example.' . $key,
                        "The {$key} key is not valid for the example field."
                    );
                }
            }
        });
    }

    // 可选：自定义默认array规则的错误消息
    public function messages()
    {
        return [
            'example.array' => 'The example field must be an array.',
        ];
    }
}

这种方式直接灵活，能精准定位每个非法键，给用户最明确的提示。

方法二：创建自定义验证规则 #

通过自定义规则类封装数组键白名单校验逻辑，同时返回带非法键名的错误消息：

1. 生成自定义规则类 #

执行Artisan命令生成规则文件：

php artisan make:rule AllowedArrayKeys

2. 编写规则逻辑 #

修改生成的App\Rules\AllowedArrayKeys类，保存非法键并返回自定义消息：

namespace App\Rules;

use Illuminate\Contracts\Validation\Rule;

class AllowedArrayKeys implements Rule
{
    protected $allowedKeys;
    protected $invalidKeys = [];

    // 构造函数传入允许的键名数组
    public function __construct(array $allowedKeys)
    {
        $this->allowedKeys = $allowedKeys;
    }

    public function passes($attribute, $value)
    {
        // 先校验是否为数组
        if (!is_array($value)) {
            return false;
        }
        
        // 获取非法键列表
        $this->invalidKeys = array_diff(array_keys($value), $this->allowedKeys);
        
        return empty($this->invalidKeys);
    }

    // 返回自定义错误消息
    public function message()
    {
        if (!empty($this->invalidKeys)) {
            $firstInvalidKey = reset($this->invalidKeys);
            return "The {$firstInvalidKey} key is not valid for the :attribute field.";
            // 若需提示所有非法键，可替换为：
            // return "Invalid keys for :attribute field: " . implode(', ', $this->invalidKeys);
        }
        
        return 'The :attribute field must be an array with valid keys.';
    }
}

3. 在FormRequest中使用自定义规则 #

更新rules方法，用自定义规则替代原生的array:xxx规则（或保留array规则单独处理格式错误）：

public function rules()
{
    return [
        'example' => [
            'array', // 保留原生规则处理数组格式错误
            new \App\Rules\AllowedArrayKeys(['something', 'another']),
        ],
    ];
}

内容的提问来源于stack exchange，提问作者Ari Cooper-Davis