ThinkPHP6多语言切换失效的四大原因：一是Nginx伪静态未透传$query_string导致lang参数丢失；二是LoadLangPack中间件未启用或顺序错误；三是前端跳转硬编码清空查询参数；四是域名级切换与URL参数冲突时lang被静默忽略。
伪静态规则没透传 query_string，lang 参数被截断
ThinkPHP6 的多语言切换依赖 ?lang=en-us 这类参数驱动侦测逻辑，但 Nginx 伪静态配置若漏掉 $query_string，所有带参跳转都会丢掉 lang。常见于二级目录部署或入口非根路径的场景。
检查你的 Nginx location 块是否包含完整 fallback 行：
try_files $uri $uri/ /index.php?$query_string;
如果项目在二级目录（如 /myapp/），必须同步调整两处：
location /myapp/ { ... }- fallback 路径改为
/myapp/index.php?$query_string - 若入口是
public/index.php，则 fallback 应为/public/index.php?$query_string
漏掉 $query_string 的直接后果：点击语言切换链接后跳转首页，URL 变成 / 而非 /?lang=en-us，Lang::getLangSet() 返回默认语言。
立即学习“PHP免费学习笔记（深入）”；
Lang 中间件未启用或顺序错位，导致语言侦测未执行
语言参数识别不是自动发生的，必须靠 think\middleware\LoadLangPack 中间件在请求早期解析 $_GET['lang'] 并设置上下文。不注册、注释掉、或放在路由中间件之后，都会让整个侦测链失效。
确认以下三点：
-
app/middleware.php中已加入'think\middleware\LoadLangPack'，且未被注释 - 该中间件在数组中位置靠前（建议在
SessionInit之后、CheckRequestCache之前） - 多应用模式下，每个应用的
app/应用名/middleware.php都需单独配置
中间件未生效时，Lang::getLangSet() 永远返回 config('lang.default_lang')，无论 URL 是否带 lang 参数。
前端跳转用的是相对路径或 JS location.href，没保留查询参数
很多语言切换按钮写的是 location.href = '/' 或 <a href="/">中文</a>，这类硬编码跳转会清空所有 query 参数。框架不负责帮你拼回去。
正确做法是动态构造带参 URL：
- 模板中用
url('index/index', ['lang' => 'en-us'])生成完整链接 - JS 中读取当前 URL 的
search，再替换lang值：new URL(location).searchParams.set('lang', 'ja-jp') - 避免手写
location.href = '/?lang=xx'—— 它会丢掉原有其他参数（如?id=123&lang=zh-cn）
尤其注意表单提交：若 <form action="/submit"> 且当前 URL 含 ?lang=xx，提交后参数必然丢失，必须显式把 lang 作为隐藏字段传入。
域名级语言切换与 URL 参数冲突，lang 被静默忽略
当开启 allow_url_lang（即 config/lang.php 中 'allow_url_lang' => true）时，ThinkPHP 的 CheckLangBehavior 会优先从 GET 参数读取语言，并直接跳过域名匹配逻辑。这意味着 ja.example.com?lang=zh-cn 一定会切到中文，而不是按域名走日语。
如果你同时用域名和 URL 参数做语言控制，必须明确取舍：
- 只用域名：关掉
allow_url_lang，并在中间件里手动根据$_SERVER['HTTP_HOST']设置Config::set('lang.default_lang', $map[$host]) - 只用 URL 参数：确保
detect_var配置与前端传参 key 一致（默认是lang），且allow_lang_list包含该值 - 混用需自定义行为：重写
think\behavior\CheckLangBehavior，在读取 GET 前先判断 Host 是否在映射表中
这个冲突点非常隐蔽——页面看起来能切语言，但换域名访问时始终 fallback 到默认语言，查日志也看不到报错。
