Laravel返回验证视图时遭遇Method Not Allowed错误求助

错误信息 #

Method Not Allowed

Symfony\Component\HttpKernel\Exception\MethodNotAllowedHttpException
The GET method is not supported for route /profile/details_options Supported methods: POST.

路由配置（web.php） #

// 显示验证员工用户名表单的页面
Route::view('/check_uname', 'template.viewhere')->name('route.name');

// /check_uname页面表单的提交接口
Route::post('/profile/details_options', [FirstController::class, 'firstEndpointFunction'])->name('uname.details_options');

// page2.displayPage页面表单的提交接口
Route::post('/profile/verify_changes', [SecondController::class, 'secondEndpointFunction'])->name('verify.detail_changes');

/check_uname页面表单代码 #

<form action="{{ route('uname.details_options')}}">
<!-- 输入框 -->
</form>

FirstController.php处理逻辑 #

public function firstEndpointFunction(Request $request)
{
    // 业务逻辑，条件满足时返回page2.displayPage视图并传递数据
    if(true){
        return view('page2.displayPage', [
            'data' => $data,
            'data2' => $data2,
            'data3' => $data3
        ]);
    }
    else {
    }
}

此时页面跳转到page2.displayPage，但URL仍停留在POST路由地址/profile/details_options。

page2.displayPage页面表单代码 #

<form action="{{ route('verify.detail_changes')}}">
<!-- 输入框 -->
</form>

SecondController.php处理逻辑 #

public function secondEndpointFunction(Request $request)
{
    if(true){
        return response()->json(['message' => 'The input is correct.']);
    }
    else{
        // 输入不匹配数据库时触发错误，目标是返回错误提示
        return redirect()->back()->withInput()->withErrors(['error' => 'Nothing has found.']);
    }
}

问题详情 #

输入不匹配数据库时抛出上述Method Not Allowed错误，已尝试php artisan route:cache和php artisan route:clear，问题未解决，需修复方案。

修复方案 #

1. 给表单指定POST方法并添加CSRF令牌 #

HTML表单默认用GET方法提交，而你的路由配置为POST接口，必须显式指定提交方法，同时Laravel需要CSRF令牌验证：

修改/check_uname页面表单：

<form action="{{ route('uname.details_options')}}" method="POST">
    @csrf
    <!-- 输入框 -->
</form>

修改page2.displayPage页面表单：

<form action="{{ route('verify.detail_changes')}}" method="POST">
    @csrf
    <!-- 输入框 -->
</form>

2. 避免直接在POST路由返回视图，改用重定向到GET路由 #

当前firstEndpointFunction直接返回视图，导致页面URL停留在POST-only路由/profile/details_options。后续重定向回此页面时，浏览器用GET请求该路由，触发方法不允许错误。

步骤1：新增显示page2.displayPage的GET路由

在web.php中添加：

// 显示page2.displayPage的GET路由
Route::get('/profile/display_page', [FirstController::class, 'showDisplayPage'])->name('profile.display_page');

步骤2：修改FirstController逻辑

public function firstEndpointFunction(Request $request)
{
    // 业务逻辑
    if(true){
        // 将数据存入session传递
        session()->put([
            'data' => $data,
            'data2' => $data2,
            'data3' => $data3
        ]);
        // 重定向到GET路由
        return redirect()->route('profile.display_page');
    }
    else {
        // 验证失败时重定向回原表单
        return redirect()->back()->withErrors(['error' => '验证失败'])->withInput();
    }
}

// 新增方法用于渲染page2.displayPage
public function showDisplayPage(Request $request)
{
    // 从session取出数据
    $data = session()->get('data');
    $data2 = session()->get('data2');
    $data3 = session()->get('data3');
    
    // 清除session避免数据残留
    session()->forget(['data', 'data2', 'data3']);
    
    return view('page2.displayPage', compact('data', 'data2', 'data3'));
}

3. 验证重定向逻辑 #

修改后，secondEndpointFunction中redirect()->back()会指向GET路由/profile/display_page，浏览器用GET请求此路由合法，不会再触发Method Not Allowed错误。

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