线上多语言切换失效主因是语言包未加载或中间件被跳过；需检查LoadLangPack中间件是否注册、语言包路径是否为小写短横线格式（如zh-cn.php）、Web服务器是否透传lang参数、runtime缓存是否清理及多应用下各配置是否独立生效。
线上多语言切换失效，90%不是代码写错，而是语言包没加载或中间件被跳过——本地能切，说明逻辑没问题；线上切不动，基本是环境配置断在了中间件、路径或缓存这三关。
LoadLangPack中间件是否真在运行
ThinkPHP6不启用think\middleware\LoadLangPack，语言包根本不会自动加载，所有lang()调用都返回键名本身。线上环境常因中间件数组被覆盖、条件判断误删、或部署时未同步app/middleware.php导致该中间件缺失。
- 检查
app/middleware.php中是否明确包含'think\middleware\LoadLangPack'，且位置在全局中间件列表里（不能只放在某个应用的中间件配置中） - 若用了多应用模式（如
app/home/和app/api/），需确认app/home/middleware.php等子应用的中间件文件也启用了该中间件 - 执行
php think route:middleware，搜索LoadLangPack是否出现在输出列表中；不在则说明注册失败
语言包路径是否符合线上大小写与命名规范
Linux服务器严格区分大小写，而Windows开发环境不敏感。本地app/lang/zh_CN.php能工作，线上zh_CN.php会被忽略——TP6只认zh-cn.php这种小写短横线格式，且必须放在app/lang/下（单应用）或app/应用名/lang/（多应用）。
- 删除所有带下划线（
zh_CN）、大写（ZH-CN）、简写（zh）或嵌套目录（app/lang/zh/cn.php）的语言包文件 - 统一重命名为
app/lang/zh-cn.php、app/lang/en-us.php，确保文件内容以return [ ... ];开头，无BOM、无空行、无echo - 多应用下，比如
home应用，语言包路径必须是app/home/lang/zh-cn.php，且config/lang.php中default_lang和allow_lang_list需与之匹配
语言侦测参数是否被Nginx/Apache拦截或覆盖
线上常因Web服务器配置导致GET参数（如?lang=en-us）无法透传给PHP，或Cookie被跨域策略拒绝，最终回退到default_lang且无法切换。
立即学习“PHP免费学习笔记（深入）”；
- 确认Nginx配置中
try_files语句包含$query_string，例如：try_files $uri $uri/ /index.php?$query_string;；缺它会导致?lang=xx被丢弃 - 检查Apache是否开启
AllowOverride All，否则.htaccess里的RewriteCond %{QUERY_STRING}规则不生效 - 前端用
fetch或axios切换语言时，若未携带credentials: 'include'，Cookie写入会失败，导致下次请求仍读不到上次选的语言
runtime缓存是否锁死旧语言配置
TP6在APP_DEBUG = false时会把语言包编译进runtime/lang/，一旦生成，改app/lang/zh-cn.php也不会生效——本地开debug看不到这问题，线上却卡死在旧翻译里。
- 清空
runtime/lang/整个目录（不要只删部分文件），再访问一次带?lang=en-us的页面触发重新编译 - 检查
config/lang.php中cache_time是否设为0（禁用缓存），避免上线后又陷入缓存陷阱 - 若用CI/CD自动部署，确保
runtime/目录不被Git跟踪，且部署脚本包含php think clear:lang步骤
最易被忽略的是：多应用模式下，每个应用的语言包路径、中间件启用、config/lang.php加载时机都相互独立，改了app/lang/对app/api/完全无效——得挨个应用查三处：中间件、路径、配置。
