Laravel中required验证规则对status字段失效问题求助

问题现象 #

• 当code字段为空时，required验证正常触发，但status单选框未选择时，required验证不生效；
• 当code字段为空触发验证时，页面同时显示code和status字段的错误提示。

相关代码 #

MeetingRequest 验证类 #

class MeetingRequest extends FormRequest
{
    public function authorize(): bool
    {
        return true;
    }
    public function rules(): array
    {
        switch($this->method())
        {
            case 'POST' || 'PATCH' || 'PUT':
            {
                return [
                    'code' => 'required|max:255',
                    'title' => 'required|max:255',
                    'start_at' => 'required|date_format:d/m/Y|before_or_equal:finish_at|required_with:finish_at',
                    'finish_at' => 'required|date_format:d/m/Y|after_or_equal:start_at|required_with:start_at',
                    'status' => 'required|boolean',
                ];
            }
            default:break;
        }
    }
    public function attributes(): array
    {
        return [
            'code' => __('common.code'),
            'title' => __('common.title'),
            'start_at' => __('common.start-at'),
            'finish_at' => __('common.finish-at'),
            'status' => __('common.status'),
        ];
    }
    public function failedValidation(Validator $validator)
    {
        return back()->with('method', $this->method())->with('route', url()->current())->withErrors($this->validator)->withInput();
    }
}

表单提交数据示例 #

_token: 
7xaYV7FieVxRwY0lAM4x13DTrZDHLJQ7XQJloh0x
code: 
111
title: 
11
start_at: 
07/04/2023
finish_at: 
07/04/2023

控制器store方法 #

public function store(MeetingRequest $request)
{
    if ($request->validated()) {
        $meeting = new Meeting();
        $meeting->customer_id = Auth::user()->customer->id;
        $meeting->code = $request->input('code');
        $meeting->title = $request->input('title');
        $meeting->start_at = $request->input('start_at');
        $meeting->finish_at = $request->input('finish_at');
        $meeting->status = $request->input('status');
        if ($meeting->save()) {
            return back()->with('success', __('common.created-successfully'));
        } else {
            return back()->with('create_modal', true)->with('error', __('common.a-system-error-has-occurred'))->withInput();
        }
    }
}

表单视图 #

<x-crud.form.common.edit>
    @section('default-edit-form')
        <x-input.text method="e" name="code" title="code" icon="code-simple" />
        <x-input.text method="e" name="title" title="title" icon="input-text" />
        <x-input.date method="e" name="start_at" title="start-at" icon="calendar-arrow-up" />
        <x-input.date method="e" name="finish_at" title="finish-at" icon="calendar-arrow-down" />
        <x-input.radio method="e" name="status" title="status" :options="$statuses" option_value="value" option_name="title" icon="toggle-large-on" />
    @endsection
</x-crud.form.common.edit>

Radio组件视图 #

@props(['method' => 'm', 'name', 'title', 'options', 'option_value', 'option_name', 'icon' => 'question'])
<div class="col form-group mb-3">
    <label for="{{ $method }}-{{ $name }}" class="form-label">
        <i class="fa-regular fa-{{ $icon }}"></i> {{ __('common.'.$title) }}
    </label>
    <div class="btn-group w-100" role="group" aria-label="{{ __('common.'.$title) }}">
        @foreach($options as $option=>$value)
            <input type="radio" name="{{ $name }}" class="btn-check" id="{{ $method }}-{{ $name }}-{{ $value[$option_value] }}" value="{{ $value[$option_value] }}"{{ ((old($name) !== null) && old($name) == $value[$option_value]) ? ' checked' : '' }} />
            <label class="btn btn-outline-{{ $value['color'] }}" for="{{ $method }}-{{ $name }}-{{ $value[$option_value] }}">{{ $value[$option_name] }}</label>
        @endforeach
    </div>
    @error($name)
        <div class="invalid-feedback d-block">
            <i class="fa-regular fa-triangle-exclamation"></i> {{ $message }}
        </div>
    @enderror
</div>

问题根源 #

1. switch分支逻辑错误：case 'POST' || 'PATCH' || 'PUT':写法完全错误，逻辑或运算会返回布尔值true，而$this->method()返回的是字符串（如'POST'），导致switch根本不会进入验证规则分支，等于没设置任何自定义验证规则；
2. 单选框提交特性：HTML中单选框未选中时，表单提交不会携带该字段，Laravel的required规则仅在字段存在但为空时触发，字段不存在则不会触发验证；
3. 错误提示批量显示：Laravel默认会一次性返回所有验证错误，若未设置停止验证，所有必填项的错误会同时显示。

解决方案 #

1. 修复switch分支逻辑 #

这是核心问题，将rules方法中的switch改为正确的多case匹配写法：

public function rules(): array
{
    switch($this->method())
    {
        case 'POST':
        case 'PATCH':
        case 'PUT':
            return [
                'code' => 'required|max:255',
                'title' => 'required|max:255',
                'start_at' => 'required|date_format:d/m/Y|before_or_equal:finish_at',
                'finish_at' => 'required|date_format:d/m/Y|after_or_equal:start_at',
                'status' => 'required|boolean',
            ];
        default:
            return []; // 默认返回空规则数组
    }
}

同时移除start_at和finish_at上多余的required_with规则（已有required，无需重复）。

2. 确保单选框未选中时触发验证 #

在radio组件的视图中，添加一个同名隐藏input，兜底提交空值：

<div class="btn-group w-100" role="group" aria-label="{{ __('common.'.$title) }}">
    <!-- 隐藏input：未选单选框时也会提交status字段，值为空 -->
    <input type="hidden" name="{{ $name }}" value="">
    @foreach($options as $option=>$value)
        <input type="radio" name="{{ $name }}" class="btn-check" id="{{ $method }}-{{ $name }}-{{ $value[$option_value] }}" value="{{ $value[$option_value] }}"{{ ((old($name) !== null) && old($name) == $value[$option_value]) ? ' checked' : '' }} />
        <label class="btn btn-outline-{{ $value['color'] }}" for="{{ $method }}-{{ $name }}-{{ $value[$option_value] }}">{{ $value[$option_name] }}</label>
    @endforeach
</div>

这样无论是否选择单选框，请求中都会携带status字段，required规则能正常触发。

3. 控制错误提示仅显示第一个（可选） #

若不想所有错误同时显示，在MeetingRequest中添加方法让验证器遇到第一个错误即停止：

public function stopOnFirstFailure(): bool
{
    return true;
}

这样code为空时，只会显示code的错误提示，不会同时弹出status的错误。

4. 修复failedValidation方法（可选） #

自定义的failedValidation可能干扰Laravel默认错误处理，建议直接删除；若需保留，改为标准异常抛出写法：

use Illuminate\Validation\ValidationException;

public function failedValidation(Validator $validator)
{
    throw ValidationException::withMessages($validator->errors())
        ->redirectTo(url()->previous())
        ->with('method', $this->method())
        ->with('route', url()->current())
        ->withInput();
}

内容的提问来源于stack exchange，提问作者Mert D. Luffy