Laravel多语言本地化问题：路由加载前无法获取用户会话致URL异常

问题场景 #

项目需通过URL首段（segment(1)）设置Locale以保障应用正常运行，因此在RouteServiceProvider的boot方法中添加了以下代码：

if (in_array(request()->segment(1), ['ca', 'en', 'es', 'nl']))
{
    request()->segment(1)
        ? app()->setLocale(request()->segment(1))
        : app()->setLocale('en');
}

同时在LocaleMiddleware中根据登录用户的设置覆盖Locale：

if (Auth::check())
{
    app()->setLocale($request->user()->getLocale());
}

当前出现异常：当应用Locale为nl时，刷新或返回页面后URL会自动切换为en，导致模型详情页404——实际用户Locale是nl，但URL使用en后，系统会查找en版本的Slug而非nl版本。核心矛盾在于：必须在路由加载前设置Locale，但此时无法在Provider中获取登录用户或会话信息。

问题根源 #

RouteServiceProvider的boot方法执行时机早于中间件，导致先根据URL设置Locale，随后中间件又用用户的Locale覆盖了应用内部的Locale。这就造成URL中的Locale和应用内部的Locale不一致，当Laravel生成URL时（如刷新页面、生成返回链接），会使用应用内部的Locale，但路由匹配依赖URL中的Locale，最终引发冲突和404。

解决方案 #

方案1：中间件统一处理Locale，确保URL与应用Locale同步 #

移除RouteServiceProvider中设置Locale的代码，改用中间件统一管控，同时确保该中间件在路由匹配前执行（将其放在web中间件组的最前列）。

修改LocaleMiddleware逻辑，兼顾登录/未登录场景，始终保证URL与应用Locale一致：

public function handle($request, Closure $next)
{
    $allowedLocales = ['ca', 'en', 'es', 'nl'];
    $defaultLocale = 'en';

    // 登录用户优先使用个人Locale
    if (Auth::check()) {
        $userLocale = $request->user()->getLocale();
        // 校验用户Locale合法性，非法则 fallback 到默认值
        $userLocale = in_array($userLocale, $allowedLocales) ? $userLocale : $defaultLocale;

        // URL与用户Locale不一致则重定向
        if ($request->segment(1) !== $userLocale) {
            $segments = $request->segments();
            $segments[0] = $userLocale;
            return redirect()->to(implode('/', $segments));
        }

        app()->setLocale($userLocale);
    } else {
        // 未登录用户使用URL中的Locale，非法则重定向到默认Locale
        $currentUrlLocale = $request->segment(1);
        $targetLocale = in_array($currentUrlLocale, $allowedLocales) ? $currentUrlLocale : $defaultLocale;

        if ($currentUrlLocale !== $targetLocale) {
            $segments = $request->segments();
            $segments[0] = $targetLocale;
            return redirect()->to(implode('/', $segments));
        }

        app()->setLocale($targetLocale);
    }

    return $next($request);
}

同时确保所有路由都包裹在Locale前缀组内：

Route::prefix('{locale}')->group(function () {
    // 所有业务路由定义在此
});

方案2：会话暂存用户Locale，路由加载前同步 #

若必须在路由加载前设置Locale，可通过会话暂存用户Locale偏好，结合RouteServiceProvider处理：

1. 在LocaleMiddleware中存入用户Locale到会话：

if (Auth::check()) {
    $userLocale = $request->user()->getLocale();
    app()->setLocale($userLocale);
    session(['user_locale' => $userLocale]);
}

2. 修改RouteServiceProvider的boot方法，优先从会话取Locale，再回退到URL或默认值：

public function boot()
{
    $allowedLocales = ['ca', 'en', 'es', 'nl'];
    $defaultLocale = 'en';

    // 先尝试从会话获取用户Locale，没有则用URL首段或默认值
    $targetLocale = session('user_locale', $request->segment(1));
    $targetLocale = in_array($targetLocale, $allowedLocales) ? $targetLocale : $defaultLocale;

    app()->setLocale($targetLocale);

    // URL与目标Locale不一致则重定向
    if ($request->segment(1) !== $targetLocale) {
        $segments = $request->segments();
        $segments[0] = $targetLocale;
        return redirect()->to(implode('/', $segments));
    }

    parent::boot();
}

注意：需确保会话已初始化，可将StartSession中间件提前到路由匹配前执行。

核心原则 #

始终保证URL中的Locale参数与应用内部的Locale完全一致，避免生成URL或路由匹配时出现冲突；处理逻辑需覆盖登录/未登录两种场景，Locale不匹配时及时重定向，从根源避免404问题。

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