不能跳过6.x直接从5.x升到7.x，必须走5.4→6.4→7.4三步路径，因6.4移除AnnotationClassLoader、7.4要求PHP≥8.2及ICU 72+，且路由、翻译、secret等存在接口断裂与配置变更。
不能跳过 6.x 直接从 5.x 升到 7.x——Composer 会卡在依赖解析阶段，或升级后路由全 404、翻译加载失败、
报错，这些都不是配置问题，而是版本断层导致的接口断裂。
必须走 5.4 → 6.4 → 7.4 三步路径
直接
几乎必然失败。原因很实在：Symfony 6.4 移除了
，而 5.x 项目普遍依赖注解路由；7.4 要求 PHP ≥ 8.2 且
必须带 ICU 72+ 数据，但 5.x 项目常运行在 PHP 7.4 + intl 69 上。
先升到
，跑通
和全部测试
再切到
，重点改两处：
中把
改成
，所有
注释手动转成
最后升
，此时必须确认
，且
显示的是
，不是 polyfill 顶包
translation 组件最易漏检的三个断裂点
在 6→7 迁移中改动隐蔽但致命：接口方法签名收紧、类被
、命令行行为变更。不处理就会出现“翻译文件存在却返回空字符串”或测试里
找不到。
现在强制要求返回
，旧实现只返回数组会静默失败
替代了已废弃的
，继承关系一错，整个测试套件就挂
是 6.4 加的，但 7.4 默认用它写入 YAML，若旧代码依赖扁平键名（如
），得加
保持兼容
别信“自动修复”，upgrade-fixer 只能扫基础语法
对
转换和
替换有用，但它不会动你的自定义
类，也不会告诉你
已被标记为
——而你可能正继承它做调试面板扩展。
运行
后，必须人工检查所有
的文件
搜索
、
、
——这些在 6.0 已移除，得换成
提供的兼容层
执行
（7.2+ 新增），它比旧版
更早暴露键名嵌套错误
secret、intl、env 这三个配置项最容易踩坑
升级后第一个报错往往不是代码，而是容器构建失败：
或
。它们都发生在
阶段，没堆栈，只报错。
不再读
，必须删掉
和
里的
，改用
环境变量
在 Alpine 镜像里默认不带完整 ICU 数据，光
不够，得重编译 PHP 或换用
官方镜像
在 7.4 中对未定义环境变量默认返回空字符串，而非抛异常，导致某些条件判断失效，建议在
里显式写
真正麻烦的从来不是命令怎么敲，而是那些没报错却逻辑错位的地方：比如路由加载顺序变了导致前缀覆盖、翻译缓存键生成规则更新导致多语言切换失效、甚至
下 Profiler 显示的弃用警告被日志级别过滤掉了。升级不是一次构建，是连续三次验证——每次升完，盯着
里有没有
行，比看控制台输出重要得多。
kernel.secretcomposer update symfony/*:^7.4AnnotationClassLoaderext-intlsymfony/framework-bundle:^5.4bin/console debug:container^6.4config/routes/annotations.yamltype: annotationtype: attribute@Route#[Route]^7.4PHP_VERSION_ID >= 80200composer show symfony/intl^7.4symfony/translationfinalProviderFactoryTestCaseProviderInterface::load()MessageCatalogueInterfaceAbstractProviderFactoryTestCaseProviderFactoryTestCasetranslation:pull --as-treeform.submit--flatsymfony/upgrade-fixer#[Route]transChoice()LoaderDataCollectorTranslatorfinalvendor/bin/upgrade-fixer fix src/ --rules=@phpunit75,@symfony70use Symfony\Component\Translation\*new Locale(DateFormatter::NumberFormatter::symfony/polyfill-intl-icubin/console lint:translationsdebug:translationYou have requested a non-existent parameter "secret"IntlException: Cannot load ICU resourceKernel::boot()kernel.secret%secret%framework.yamlsecurity.yamlsecret: '%secret%'APP_SECREText-intlapk add icu-devphp:8.2-apache%env(APP_ENV)%.envAPP_ENV=devAPP_DEBUG=truevar/log/dev.logDEPRECATED