Thinkphp6多语言中间件未生效排查与修复-ThinkPHP-PHP中文网

loadlangpack中间件未生效的主因是未显式注册或顺序错误：必须在app/middleware.php中返回含\think\middleware\loadlangpack::class的数组，置于sessioninit之后、路由之前，且文件不能有bom或空白行。

thinkphp6多语言中间件未生效排查与修复

ThinkPHP 6 的多语言中间件（think\middleware\LoadLangPack）未生效，不是语言包写错了，而是它根本没被加载——请求连语言侦测环节都没进，lang() 就只能返回键名或空字符串。

这个中间件不会自动启用，必须显式注册，且顺序不能错：它得在 Session 初始化之后、路由调度之前执行，否则读不到 Cookie 或 Header。

app/middleware.php 必须存在，且返回数组，例如：

return [
    \think\middleware\LoadLangPack::class,
    \think\middleware\SessionInit::class,
    // 其他中间件...
];

如果用了多应用模式（app/multi_app = true），该文件需放在对应应用目录下，比如 app/admin/middleware.php，全局的不生效
别把它放在 think\middleware\Cors::class 后面——CORS 中间件若提前终止响应（如 OPTIONS 返回 204），LoadLangPack 根本不会运行
检查是否误写成 Lang 或 LangPack —— 正确类名是 think\middleware\LoadLangPack，少一个单词或大小写错误都会静默失败

ThinkPHP 6 严格按路径和命名约定加载语言包，错一个字符就跳过，还不报错。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

单应用下路径必须是 app/lang/zh-cn.php，不是 app/lang/zh_CN.php、app/lang/zh.php 或 lang/zh-cn.php
每个语言文件必须以 return [ ... ]; 结尾，开头不能有 BOM、空格、echo、var_dump 或任何输出
多应用时路径为 app/api/lang/en-us.php，命名空间和配置中的 default_lang 必须完全匹配（包括大小写和短横线）
如果用 Lang::get('user.name')，确保 zh-cn.php 里有 'user.name' => '用户名称'，不能指望自动嵌套解析

语言切换靠 GET → Cookie → Header → HTTP_ACCEPT_LANGUAGE 顺序侦测，但前端传参方式不对，或者后端配置开关关了，就会永远卡在默认语言。

确认 config/lang.php 中 'detect_var' => 'lang'，这样 ?lang=ja-jp 才有效；如果设成 'l'，却传 ?lang=ja-jp，那就白搭
Cookie 键名必须是 think_lang，不是 lang 或 language；写 Cookie 要用 cookie('think_lang', 'ja-jp')，手写 setcookie('lang', ...) 不识别
Header 方式需开启且指定变量名：'header_var' => 'think-lang'，然后前端发 think-lang: zh-cn；注意冒号后有空格，框架对格式敏感
当 ?lang=en-us 和 Cookie[think_lang]=zh-cn 同时存在时，GET 参数优先级最高——别怪 Cookie 没生效，其实是被 URL 覆盖了

Lang::set('en-us') 是运行时覆盖，但它不改 Cookie，也不触发中间件重载，只影响当前请求后续的 lang() 调用。

在控制器里调 Lang::set('ja-jp') 后，再调 lang('welcome') 会生效；但页面刷新后又回退到 Cookie 值——这是预期行为，不是 bug
想持久化切换，必须同步写 Cookie：cookie('think_lang', 'ja-jp');，且确保路径（path）和域名（domain）与中间件读取时一致
别在中间件 handle() 里调 Lang::set() 再 return，这等于自己覆盖自己；中间件的作用是“初始化”，不是“动态重设”
如果用了 Swoole 或 RoadRunner，Lang 状态可能跨请求残留，需确认是否启用了 lang_auto_load 或手动清缓存