使用Laravel+InertiaJS/React时接口返回409 Conflict并触发页面刷新

问题描述 #

作为InertiaJS新手，点击按钮调用Laravel接口时遇到409 Conflict错误，浏览器会强制刷新页面才显示内容。预期Inertia能无刷新更新CompanyProfile组件，但实际不符合预期。尝试过Inertia.replace()及修改HandleIntertiaRequests.php的version方法，均未解决。

前端React组件代码 #

export default function CompanyInformation({ auth }) {
    const { errors, data } = usePage().props;

    const handleButtonClick = async (value) => {
        await Inertia.get("/company-information/profile", {
            symbol: value,
        });
    };

    return (
        // ... 组件部分代码 ...
        {data && (
            <CompanyProfile
                details={data.company_profile}
            />
        )}
        // ... 组件剩余代码 ...
    );
} 

Laravel控制器代码 #

public function getCompanyInformation(Request $request)
{
    try {
        // ... 处理逻辑 ...
        $response = [
            'company_profile' => $result
        ];

        return Inertia::render('CompanyInformation', ['data' => $response]);
    } catch (Exception $e) {
        return Inertia::render('CompanyInformation', ['errors' => [
            'exception' => $e->getMessage()
        ]]);
    }
}

解决步骤 #

1. 彻底修复409 Conflict的核心问题 #

409 Conflict在Inertia中几乎都是页面版本不匹配导致的，Inertia会在版本不一致时强制刷新页面。即使修改过version方法，可能存在逻辑错误导致前后端版本不统一：

修改app/Http/Middleware/HandleInertiaRequests.php的version方法，确保前后端版本一致：

public function version(Request $request)
{
    // 生产环境用mix manifest哈希，保证资源更新时版本同步变化
    if (app()->environment('production')) {
        return md5_file(public_path('mix-manifest.json'));
    }
    // 开发环境固定版本，避免频繁触发409
    return 'dev-1.0';
}

2. 修正路由与响应逻辑 #

• 确认Laravel路由定义为GET方法（在routes/web.php中）：

  Route::get('/company-information/profile', [CompanyController::class, 'getCompanyInformation']);
  

• 后端异常处理改用back()->withErrors，让Inertia自动处理错误更新，避免强制刷新：

  catch (Exception $e) {
      return back()->withErrors([
          'exception' => $e->getMessage()
      ]);
  }
  

3. 前端请求优化 #

如果需要保留当前页面状态，可在请求时添加preserveState参数，避免状态丢失：

await Inertia.get("/company-information/profile", { symbol: value }, { preserveState: true });

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