Laravel 8 实现仅保留首字段验证错误，移除其余字段错误信息

问题背景 #

使用Laravel 8开发时，需要验证phNo_1、phNo_2、phNo_3三个字段组合成完整手机号，验证通过后将组合值存入数据库。要求：

• 任意字段格式错误（含非数字、长度超过4位等）时触发验证
• 仅在phNo_1字段显示错误消息，移除phNo_2、phNo_3的错误提示
• 仅通过后端逻辑实现，不修改前端代码

当前验证逻辑已实现，但返回前端时无法移除phNo_2、phNo_3的错误消息；重写failedValidation方法后，日志中可见错误已删除，但无法将修改后的错误赋值回验证器（Laravel 8的$validator->errors()不支持forget方法）。

解决方案 #

方案1：从根源减少错误字段（推荐） #

无需给三个字段都绑定自定义验证规则，仅在phNo_1上应用ValidPhoneNumber规则即可——因为自定义规则本身已检查三个字段的合法性，这样phNo_2、phNo_3不会生成格式错误，仅保留必填关联校验。

修改FormRequest规则

public function rules()
{
    return [
        // 其他字段规则...
        'phNo_1' => ['nullable', 'required_with:phNo_2,phNo_3', new ValidPhoneNumber($this->input())],
        'phNo_2' => ['nullable', 'required_with:phNo_1,phNo_3'],
        'phNo_3' => ['nullable', 'required_with:phNo_1,phNo_2'],
        // 其他字段规则...
    ];
}

方案2：重写错误处理逻辑（兼容原有规则） #

如果必须保留三个字段的自定义验证规则，需在failedValidation方法中重新构建错误消息集合，替换原验证器的错误信息后抛出异常。

修改failedValidation方法

use Illuminate\Validation\ValidationException;
use Illuminate\Support\MessageBag;

protected function failedValidation(Validator $validator)
{
    $originalErrors = $validator->errors();
    $newErrors = new MessageBag();

    // 处理手机号相关错误：统一显示到phNo_1
    $hasPhoneErrors = $originalErrors->has('phNo_1') || $originalErrors->has('phNo_2') || $originalErrors->has('phNo_3');
    if ($hasPhoneErrors) {
        // 获取第一个手机号相关错误消息
        $errorMsg = $originalErrors->first('phNo_1') ?? $originalErrors->first('phNo_2') ?? $originalErrors->first('phNo_3');
        $newErrors->add('phNo_1', $errorMsg);
    }

    // 保留其他字段的错误消息
    foreach ($originalErrors->getMessages() as $field => $messages) {
        if (!in_array($field, ['phNo_1', 'phNo_2', 'phNo_3'])) {
            $newErrors->merge([$field => $messages]);
        }
    }

    // 抛出携带新错误集合的验证异常
    throw ValidationException::withValidator($validator)->errors($newErrors);
}

优化自定义验证规则（可选） #

原规则中的is_numeric会允许小数，改用ctype_digit更严谨地验证纯数字：

public function passes($attribute, $value)
{
    $ph_01 = $this->input['phNo_1'] ?? '';
    $ph_02 = $this->input['phNo_2'] ?? '';
    $ph_03 = $this->input['phNo_3'] ?? '';

    // 全部为空则通过验证
    if (empty($ph_01) && empty($ph_02) && empty($ph_03)) {
        return true;
    }

    // 验证所有字段为纯数字且长度不超过4位
    return ctype_digit($ph_01) && ctype_digit($ph_02) && ctype_digit($ph_03)
        && strlen($ph_01) <= 4 && strlen($ph_02) <= 4 && strlen($ph_03) <= 4;
}

内容的提问来源于stack exchange，提问作者Mr. Kenneth