直接说结论：Symfony 应用跑在 Kubernetes 上，关键不在“能不能”，而在「翻译资源怎么热加载」「环境变量怎么安全注入」「错误日志怎么不丢」这三件事没理清，其他配置都是边角。
如何让 translation:extract 在 CI 流水线里真正生效
很多人把 translation:extract 塞进 .gitlab-ci.yml 就以为完事了，结果发现生产环境还是旧翻译——因为默认只扫描 src/，但 Twig 模板、Vue 组件里的 {{ 'welcome'|trans }} 或 t('error.network') 根本没被扫进去。
- 必须显式加
--dir=templates --dir=assets/js（根据你实际路径调整） -
--force会覆盖已有文件，建议搭配--output-format=yaml保持格式统一，避免 YAML 缩进差异触发无意义的 Git 提交 - CI 中执行后记得
git add translations/ && git commit -m "chore: update translations"，否则下次构建还是旧 catalogue - 别在容器启动时才运行 extract——它不是 runtime 行为，是构建期动作，放错阶段会导致镜像里没更新翻译
为什么 APP_LOCALE 不能只靠环境变量硬编码
Kubernetes 的 env 字段写死 APP_LOCALE: "zh_CN" 看似简单，但一旦需要按请求动态切语言（比如用户偏好、URL 前缀），这条路就堵死了。硬编码还导致多集群部署时 locale 配置和镜像强耦合。
- 正确做法是把 locale 逻辑下沉到 Symfony 的
RequestStack+ 自定义LocaleListener，从Accept-Language头或路由参数提取，而非依赖环境变量 - 如果真要用环境变量控制 fallback locale，用
config/packages/framework.yaml中的default_locale: '%env(APP_LOCALE)%'，并确保该 env 在 Pod 启动前已注入（ConfigMap 或 Secret，别用env:直接写值） - 注意：Kubernetes ConfigMap 更新后，Pod 不会自动 reload 翻译 catalogue——必须配合
symfony/cache的cache.app使用RedisAdapter，让 Translator 从共享缓存读取最新 catalogue，而不是每次 new 一个新实例
翻译文件进容器后，为什么 messages.fr.yaml 总是 404
常见错误是 Dockerfile 里 COPY 错了路径，或者 Kubernetes 挂载 ConfigMap 时权限不对，导致 Symfony 的 YamlFileLoader 打不开文件。
- Dockerfile 中确保
COPY translations/ /app/translations/，且目录结构与config/packages/translation.yaml中的paths配置一致（默认是['%kernel.project_dir%/translations']） - 若用 ConfigMap 挂载翻译文件，注意 YAML 文件内容会被转成 UTF-8 字节流，但某些旧版 kubectl 创建的 ConfigMap 会额外加 BOM 头，导致
YamlFileLoader::load()解析失败——用kubectl create configmap ... --from-file=messages.fr.yaml而非--from-literal - 挂载点目录权限必须是
rw-r--r--（644），且容器内运行用户（如 www-data）要有读权限；用securityContext.runAsNonRoot: true时尤其容易因 UID 不匹配读失败 - 调试技巧：进容器执行
ls -l /app/translations/messages.fr.yaml && file /app/translations/messages.fr.yaml，确认文件存在、编码干净、无 BOM
最常被跳过的细节是：Translator 实例在 Symfony 容器中是单例，但它的 MessageCatalogue 是 lazy-loaded。如果你在 CLI 命令里调用 trans() 没问题，但在 HTTP 请求中返回空字符串，大概率是 cache adapter 没配对，或者 translation loader 找不到对应 locale 的 catalogue——别急着改代码，先查 var/log/prod.log 里有没有 Translation failed: no catalogue for "fr" 这类报错。
