Inertia + Laravel POST路由页面刷新报500 如何保留参数正常加载

报错根本原因 #

当前路由仅支持POST请求，浏览器F5刷新页面时默认发送GET请求，请求方法不匹配直接抛出服务端异常，这是500错误的直接诱因。就算调整路由适配GET请求，刷新时原POST请求携带的name/overview/url参数也不会自动携带，仍然会出现参数缺失的问题。

可用方案 #

方案1：参数允许暴露在URL时使用（推荐，实现最简单） #

适合参数无敏感信息的场景，直接将参数放在URL查询字符串中，刷新时自动携带。

1. 调整路由同时支持GET和POST请求：

// route.php
Route::match(['GET', 'POST'],
    '/page',
    [App\Http\Controllers\PageController::class, 'index']
)->name('page.details');

2. 跳转至该页面时，将参数拼接到路由的查询参数中，示例：

// 提交表单后的跳转逻辑
return redirect()->route('page.details', [
    'name' => $request->name,
    'overview' => $request->overview,
    'url' => $request->url
]);

此时控制器无需修改，刷新时GET请求可直接从URL中读取到对应参数。

方案2：参数敏感不允许暴露时使用 #

适合参数不能对外展示的场景，将参数临时存储在服务端session中。

1. 同样先调整路由同时支持GET和POST请求，代码同上方案1的路由配置。
2. 修改控制器逻辑，POST请求时存session，GET请求时从session读取参数：

// PageController.php
public function index(Request $request)
{
    // POST请求存储参数到session
    if ($request->isMethod('POST')) {
        session()->put('page_detail_params', [
            "name" => $request->name,
            "overview" => $request->overview,
            "url" => $request->url
        ]);
    }
    // 读取session参数，若不存在可根据业务逻辑补默认值或跳转
    $pageParams = session()->get('page_detail_params', []);
    return Inertia::render('Page/PageDetails', $pageParams);
}

如果不需要跨页面保留参数，可在读取后调用session()->forget('page_detail_params')清理session，避免下次进入页面读取到旧数据。

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