Laravel验证继承异常：RegisterUserRequest未生效自定义错误消息

问题场景 #

我最近碰到了一个验证器继承的小坑：自定义了基础验证器BaseUserRequest，让RegisterUserRequest这类业务验证器都继承它。原本以为所有子类验证器触发password:min错误时，都会返回我定义的「Custom error」消息，但实际情况却不对劲：

• 直接用BaseUserRequest验证时，自定义错误消息正常返回
• 用RegisterUserRequest验证表单触发password:min错误时，却弹出了框架默认的错误提示

一开始我还怀疑是类继承的机制出了问题，折腾半天终于找到根源。

问题根源 #

我忘记在子类的验证规则里注册/继承父类的规则了！

用代码示例就能直观看到问题所在：

基类BaseUserRequest的正确写法

class BaseUserRequest extends FormRequest
{
    /**
     * 定义基础验证规则
     */
    public function rules()
    {
        return [
            'password' => 'required|min:8',
        ];
    }

    /**
     * 自定义错误消息
     */
    public function messages()
    {
        return [
            'password.min' => 'Custom error',
        ];
    }
}

子类RegisterUserRequest的错误写法（问题出在这）

class RegisterUserRequest extends BaseUserRequest
{
    public function rules()
    {
        // 只定义了子类独有的字段规则，完全忽略了父类的password规则
        return [
            'email' => 'required|email|unique:users',
            'name' => 'required|string|max:255',
        ];
    }
}

这种情况下，RegisterUserRequest的验证规则里没有包含password的规则，即便表单提交了password字段，验证逻辑也没有关联到基类的自定义错误消息，自然就返回了框架默认提示。

解决方法 #

在子类的rules()方法中，通过parent::rules()合并父类的验证规则，这样就能同时继承基类的规则和对应的自定义错误消息：

子类RegisterUserRequest的正确写法

class RegisterUserRequest extends BaseUserRequest
{
    public function rules()
    {
        // 合并父类基础规则与子类业务规则
        return array_merge(parent::rules(), [
            'email' => 'required|email|unique:users',
            'name' => 'required|string|max:255',
        ]);
    }
}

修改后再用RegisterUserRequest验证时，触发password:min错误就会正常返回「Custom error」的自定义消息了。

内容的提问来源于stack exchange，提问作者user9250371