Symfony 6.4 是最后一个支持 PHP 8.0 的 LTS 版本，升级需同步规划 PHP 8.1+ 迁移；HttpClient 默认禁用 gzip 解压，需显式启用；表单组件废弃 getName()，改用 getBlockPrefix()；Cache 组件强制 PSR-16 类型声明。
Symfony 6.4 是最后一个支持 PHP 8.0 的 LTS 版本
别再指望 Symfony 5.4 升级到 6.4 还能跑在 PHP 8.0 上——它确实可以，但 Symfony 6.4 是最后一个兼容 PHP 8.0 的 LTS，而 Symfony 5.4 已于 2023 年 11 月结束安全支持。你现在升级，本质是在“从一个已死亡的 LTS 跳到一个即将失去 PHP 8.0 支持的 LTS”。
实操建议：
- 确认当前 PHP 版本：
php -v；若仍是 8.0，升级 Symfony 6.4 后必须同步规划 PHP 8.1+ 迁移，否则下个 LTS（7.0）将直接不兼容 - Symfony 5.4 的
symfony/framework-bundle默认依赖symfony/http-kernel ^5.4，而 6.4 要求^6.4，Composer 会拒绝混合安装，必须全量升级组件，不能只升主包 - 官方升级路径明确不支持跨大版本跳转（如 5.4 → 6.4），推荐先升到 5.4 → 6.0 → 6.4，但实践中只要测试覆盖充分，
composer update "symfony/*" "^6.4"加SYMFONY_REQUIRE=6.4环境变量可绕过部分约束
HttpClient 默认行为变更：不再自动解码 gzip 响应体
Symfony 6.4 中 Symfony\Contracts\HttpClient\HttpClientInterface 的默认配置关闭了自动 gzip 解压，而 5.4 是开启的。这会导致原本正常工作的 API 调用突然返回乱码或解析失败，错误现象常为 JSON decode error: Syntax error 或响应体开头出现 \x1f\x8b 字节。
实操建议：
- 显式启用解压：在创建客户端时传入
['enable_compression' => true]，例如：use Symfony\Component\HttpClient\HttpClient;<br>$client = HttpClient::create(['enable_compression' => true]);
- 若使用
framework.http_client配置，需在config/packages/framework.yaml中补上：http_client:<br> default_options:<br> enable_compression: true
- 注意：该选项在 5.4 中是默认
true且不可配，在 6.4+ 中默认false，且仅对Content-Encoding: gzip生效，br（Brotli）仍需手动处理
Form 组件弃用 getName()，改用 getBlockPrefix()
所有自定义表单类型类（继承 AbstractType）中，若重写了 getName() 方法，会在 6.4 启动时触发 Deprecated: The "getName()" method is deprecated since Symfony 6.2 警告，并将在 7.0 彻底删除。这不是静默变更，而是明确标记废弃。
实操建议：
- 把
getName()全部替换为getBlockPrefix()，二者返回值语义一致，但后者是唯一受支持入口 - 如果类里同时存在两个方法，6.4 会优先调用
getBlockPrefix()，getName()不再被读取 - 第三方 Bundle（如
sonata-project/formatter-bundle）若未适配 6.4，可能仍调用getName()，需检查其最新版是否已发布兼容补丁
Cache 组件强制要求 PSR-6/PSR-16 实现必须声明 clear() 返回类型
如果你实现了自定义缓存池（比如继承 AbstractAdapter 或直接实现 CacheInterface），而 clear() 方法没声明返回类型 bool，6.4 下会报 Declaration of YourCache::clear() must be compatible with Psr\SimpleCache\CacheInterface::clear(): bool。
实操建议：
- 所有自定义缓存类的
clear()方法必须补上返回类型：public function clear(): bool { ... } - 同理检查
deleteMultiple()（返回bool）、getMultiple()（返回iterable）等方法签名，PSR-16 v3+ 规范收紧了类型声明 - 若使用
cache.adapter.psr6包装器桥接旧缓存后端，请确认其版本 ≥ 2.0.0，否则无法满足新接口契约
Request::getContentTypeFormat() 在 6.4 中对 application/json; charset=utf-8 返回 json（5.4 返回 json; charset=utf-8），影响内容协商逻辑；还有 SecurityBundle 默认禁用 session 在无状态防火墙中，不显式配置 stateless: false 就可能让登录态丢失。这些不会中断部署，但会让某些请求在特定路径下静默失败。 
