Laravel 实现双字段互斥校验：两值不可同时存在

你要实现的「field1 存在则 field2 必须为空、反之亦然，二者不能同时存在」的规则，Laravel 提供了开箱即用的校验能力，无需编写复杂自定义逻辑，可根据版本和业务细节选择对应方案。 #

方案一：内置 prohibits 规则（适配 Laravel 8.0+ 版本） #

prohibits 是 Laravel 8 专门为这类互斥场景设计的校验规则：如果当前校验字段存在且为非空有效值，指定关联字段必须完全缺失，刚好匹配双向互斥的要求。
如果是通过 FormRequest 类实现校验，直接在 rules 方法中返回规则即可：

public function rules()
{
    return [
        // field1 有非空值时，field2 必须不存在
        'field1' => ['prohibits:field2'],
        // field2 有非空值时，field1 必须不存在
        'field2' => ['prohibits:field1'],
    ];
}

该规则的触发逻辑为：

• 仅当字段传入非空有效值（非 null、空字符串、空数组）时，才会触发互斥校验
• 二者可同时不传，也可只传其中一个，只要不同时传非空值就校验通过
  如果业务要求必须二选一，不能两个都不传（比如查询接口要么传用户ID要么传手机号），只需要在规则中追加 required_without 规则即可：

public function rules()
{
    return [
        'field1' => ['prohibits:field2', 'required_without:field2'],
        'field2' => ['prohibits:field1', 'required_without:field1'],
    ];
}

如果不需要单独编写 FormRequest 类，直接在控制器中通过 Validator::make 手动构造校验时，规则写法完全一致。 #

方案二：闭包条件校验（适配所有 Laravel 版本） #

如果你的 Laravel 版本低于 8.0，或者需要自定义「字段存在」的判断逻辑（比如只要请求携带了字段，哪怕值为空也算存在），可以用闭包方式实现灵活校验：

public function rules()
{
    return [
        'field1' => function ($attribute, $value, $fail) {
            // field1 有值且请求携带了 field2 时抛出错误
            if (!is_null($value) && $this->has('field2')) {
                $fail('传入 field1 时，不能同时传入 field2');
            }
        },
        'field2' => function ($attribute, $value, $fail) {
            if (!is_null($value) && $this->has('field1')) {
                $fail('传入 field2 时，不能同时传入 field1');
            }
        },
    ];
}

逻辑调整说明：如果需要「只要请求带了字段就算存在，哪怕值为空」，把闭包里的 !is_null($value) 判断去掉即可，仅保留 $this->has('字段名') 的判断。

自定义错误提示 #

默认的校验错误提示不符合业务习惯的话，可在 FormRequest 类的 messages 方法中自定义输出内容：

public function messages()
{
    return [
        'field1.prohibits' => '传入 field1 时禁止同时传入 field2',
        'field2.prohibits' => '传入 field2 时禁止同时传入 field1',
        'field1.required_without' => 'field1 和 field2 必须二选一传入',
        'field2.required_without' => 'field1 和 field2 必须二选一传入',
    ];
}

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