Laravel发送邮件时缺失必填项不返回“failed”会话问题

我之前也碰到过类似的情况，大概率是验证逻辑或视图消息渲染的环节出了问题，咱们一步步排查解决：

1. 先检查控制器的验证逻辑 #

Laravel的验证机制会自动处理失败重定向，但如果你的代码没按规范写，就会丢失错误消息。

正确的验证写法（两种方式任选） #

方式一：用$request->validate()自动验证

这个方法会在验证失败时自动重定向回表单页面，同时携带错误信息和用户输入的内容：

public function submitContactForm(Request $request)
{
    // 定义必填字段的验证规则
    $validated = $request->validate([
        'name' => 'required|string|max:255',
        'email' => 'required|email',
        'message' => 'required|min:10',
        // 其他必填字段按需添加
    ]);

    // 验证通过后执行发送邮件逻辑
    Mail::to('your-email@example.com')->send(new ContactMail($validated));

    // 成功后跳转并携带success消息
    return redirect('#contact')->with('success', '消息发送成功！');
}

方式二：手动创建Validator（适合需要自定义逻辑的场景）

如果需要在验证失败时自定义failed会话消息，要记得加上with('failed', ...)：

use Illuminate\Support\Facades\Validator;

public function submitContactForm(Request $request)
{
    $validator = Validator::make($request->all(), [
        'name' => 'required|string|max:255',
        'email' => 'required|email',
        'message' => 'required|min:10',
    ]);

    if ($validator->fails()) {
        // 重定向回表单，携带错误、用户输入和自定义失败消息
        return redirect('#contact')
            ->withErrors($validator)
            ->withInput()
            ->with('failed', '提交失败，请检查所有必填字段！');
    }

    // 发送邮件逻辑...
    return redirect('#contact')->with('success', '消息发送成功！');
}

2. 检查视图的消息渲染代码 #

控制器传了消息，但视图没渲染的话，用户自然看不到。建议同时处理会话消息和验证错误详情：

<div class="row">
    <div class="col-12">
        {{-- 显示成功/失败的会话消息 --}}
        @if(session('success'))
            <div class="alert alert-success mb-3">
                {{ session('success') }}
            </div>
        @endif

        @if(session('failed'))
            <div class="alert alert-danger mb-3">
                {{ session('failed') }}
            </div>
        @endif

        {{-- 显示具体的验证错误（比如哪个字段没填） --}}
        @if($errors->any())
            <div class="alert alert-danger mb-3">
                <strong>请修正以下问题：</strong>
                <ul class="mb-0">
                    @foreach($errors->all() as $error)
                        <li>{{ $error }}</li>
                    @endforeach
                </ul>
            </div>
        @endif

        <form action="{{ url('/#contact') }}" method="POST">
            {{ csrf_field() }}
            <div class="row">
                {{-- 示例字段：姓名 --}}
                <div class="form-group col-md-6">
                    <label for="name">姓名 *</label>
                    <input 
                        type="text" 
                        class="form-control @error('name') is-invalid @enderror" 
                        id="name" 
                        name="name" 
                        value="{{ old('name') }}"
                    >
                    {{-- 单个字段的错误提示 --}}
                    @error('name')
                        <div class="invalid-feedback">{{ $message }}</div>
                    @enderror
                </div>

                {{-- 其他表单字段同理 --}}
                <div class="col-12 mt-3">
                    <button type="submit" class="btn btn-primary">提交消息</button>
                </div>
            </div>
        </form>
    </div>
</div>

3. 额外排查点 #

• 路由配置：确保POST请求的路由指向正确的控制器方法，比如在web.php中：

  Route::post('/contact-submit', [ContactController::class, 'submitContactForm'])->name('contact.submit');
  

  然后表单的action可以改成{{ route('contact.submit') }}#contact，避免URL路径出错。
• 会话配置：检查config/session.php，确保driver不是array（array驱动不会持久化会话，测试环境可以用，但生产环境建议用file或database）。

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