Laravel 10.x基于Session的本地化功能失效求助

针对你遇到的本地化无法切换问题，按以下步骤排查修复：

1. 确认中间件已正确注册 #

打开app/Http/Kernel.php，将LocalizationMiddleware添加到web中间件组中，且必须放在StartSession中间件之后（确保Session已初始化）：

protected $middlewareGroups = [
    'web' => [
        // ...其他中间件
        \App\Http\Middleware\StartSession::class,
        \App\Http\Middleware\LocalizationMiddleware::class, // 放置在此位置
        // ...其他中间件
    ],
];

2. 检查翻译文件结构是否合规 #

确保lang目录的结构和内容完全匹配视图中的翻译调用：

• lang/en/home.php：

  <?php
  return [
      'hero' => [
          'header' => 'English Header Content'
      ]
  ];
  

• lang/id/home.php：

  <?php
  return [
      'hero' => [
          'header' => 'Konten Header Bahasa Indonesia'
      ]
  ];
  

注意文件命名、数组层级和键名必须与__('home.hero.header')完全对应。

3. 优化中间件逻辑 #

简化代码并确保命名空间正确引入：

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\App;
use Illuminate\Support\Facades\Session;
use Symfony\Component\HttpFoundation\Response;

class LocalizationMiddleware
{
    public function handle(Request $request, Closure $next): Response
    {
        // 优先读取Session语言，默认值设为'en'
        $locale = Session::get('locale', 'en');
        App::setLocale($locale);

        return $next($request);
    }
}

4. 增强控制器的语言有效性验证 #

避免传入无效语言值导致功能异常：

<?php

namespace App\Http\Controllers;

use Illuminate\Support\Facades\App;
use Illuminate\Support\Facades\Session;

class LocalizationController extends Controller
{
    public function setLang($locale)
    {
        // 限定支持的语言列表
        $supportedLocales = ['en', 'id'];
        if (in_array($locale, $supportedLocales)) {
            Session::put('locale', $locale);
            App::setLocale($locale);
        }

        return redirect()->back();
    }
}

5. 验证Session状态 #

在视图中临时添加Session输出，确认语言切换后Session值是否更新：

<p>当前语言：{{ Session::get('locale') }}</p>

点击切换链接后，查看该值是否同步变化，排查Session是否正常工作。

6. 清除应用缓存 #

运行以下命令清除缓存，避免旧缓存导致翻译不生效：

php artisan cache:clear
php artisan view:clear
php artisan config:clear

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