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