Laravel注册SetLocale中间件不生效仅在api路由设语言才有效

DevOps 小满

2026-11-1

问题核心原因

你遇到的情况完全不是SetLocale代码本身的问题，99%是两类常见的配置残留、版本适配问题：

对应现象的原理说明

为什么在config/app.php里把locale、fallback_locale都设为fr，实际运行还是返回en？
只要你之前执行过php artisan config:cache生成过配置缓存，Laravel就会直接读取bootstrap/cache/config.php里存储的旧配置值，完全忽略config目录下新修改的代码，自然会一直沿用旧的en语言设置。
为什么在routes/api.php顶部直接写app()->setLocale('fr')就能生效？
这行代码的执行时机在路由加载阶段，早于所有中间件、控制器方法的执行，直接覆盖了从旧配置里读出来的en语言值，所以测试时能看到法语翻译效果。
为什么在Kernel里注册的SetLocale中间件从来没被触发？
除了缓存残留的问题，如果是Laravel 11版本，传统的$middlewareGroups配置项已经从Kernel文件里移除，系统根本不会读取你在Kernel里写的中间件注册逻辑，自然不会加载SetLocale类。

排查解决步骤

第一步先清空所有本地残留缓存，执行命令：
php artisan optimize:clear
这个命令会一次性删除所有旧的配置缓存、路由缓存、应用缓存、视图缓存，让Laravel重新读取你新编写的配置和代码。
第二步根据Laravel版本正确注册中间件：
- 如果你使用Laravel 10及更早版本：检查app/Http/Kernel.php里的web、api中间件组代码是否存在语法错误——你贴出的api组代码片段只写了一半，要确认数组完全闭合、SetLocale类的命名空间引用正确，没有和Laravel默认的中间件项写混。
- 如果你使用Laravel 11及以上版本：删除之前在Kernel中写的冗余注册逻辑，打开bootstrap/app.php，在withMiddleware回调里把SetLocale注册到对应中间件组，示例代码：
```
->withMiddleware(function (Middleware $middleware) {
    // 将SetLocale追加到api、web两个中间件组
    $middleware->appendToGroup('api', \App\Http\Middleware\SetLocale::class);
    $middleware->appendToGroup('web', \App\Http\Middleware\SetLocale::class);
})
```
第三步验证中间件加载状态：
可以在SetLocale的handle方法第一行临时加一句日志记录，再调用你的注册接口，看日志是否写入；如果日志始终未生成，就检查测试路由是否绑定到了对应的中间件组——比如有没有使用withoutMiddleware()方法跳过中间件，或者路由被注册到了没有绑定中间件组的全局路由下。

注意：你现在写的硬编码App::setLocale('fr')只是临时测试用，正式做多语言功能时，应该在中间件中从请求头、URL参数、Session里读取用户选择的语言值，不要硬编码为单一语言，方便后续扩展多语言能力。

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

Laravel注册SetLocale中间件不生效 仅在api路由设语言才有效