Laravel 9 邮件链接无前置页面时验证请求并显示错误消息

问题原因 #

原代码使用$request->validate()，当GET请求验证失败时，Laravel会尝试重定向到前一页，但该链接通过邮件访问无前置页面，因此会跳转到基准URL，无法在目标视图中展示错误信息。

解决方案：手动创建验证器控制错误逻辑 #

放弃$request->validate()的自动重定向机制，改用Validator::make()手动验证，验证失败时直接返回指定视图并传递错误信息。

修改控制器方法 #

use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;

public function updateAppointmentStatus(Request $request, LeadService $leadService, string $uuid, int $status)
{
    // 以路由参数为数据源创建验证器
    $validator = Validator::make(
        ['uuid' => $uuid, 'status' => $status],
        [
            'uuid' => ['required', 'uuid'],
            'status' => ['required', 'numeric', Rule::in(Lead::STATUSES)],
        ]
    );

    // 验证失败时返回指定视图，传递错误和路由参数
    if ($validator->fails()) {
        return view('leads.update-status')
            ->withErrors($validator)
            ->with(compact('uuid', 'status'));
    }

    // 验证通过后执行原有业务逻辑
    $lead = Lead::where('uuid', $uuid)->firstOrFail();
    $leadService->updateStatus($lead, $status);

    return view('leads.update-status')->with(compact('lead'));
}

在视图leads.update-status.blade.php中显示错误 #

通过Laravel自带的$errors变量或@error指令展示错误：

方式1：展示所有错误

@if ($errors->any())
    <div class="alert alert-danger">
        <ul>
            @foreach ($errors->all() as $error)
                <li>{{ $error }}</li>
            @endforeach
        </ul>
    </div>
@endif

方式2：展示单个字段的错误

@error('uuid')
    <div class="text-danger">{{ $message }}</div>
@enderror

@error('status')
    <div class="text-danger">{{ $message }}</div>
@enderror

补充说明 #

• 由于是GET请求，直接使用路由参数$uuid和$status作为验证数据源，无需从$request中获取。
• 通过withErrors($validator)将错误信息绑定到视图后，Laravel会自动注入$errors变量供视图调用。
• 验证失败时传递uuid和status参数到视图，可用于后续的重试提示或页面回显。

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