composer why-not 能精准定位包版本安装失败的硬性阻断点，关键看 requires、conflicts 行及末尾 platform requirements 不匹配项，三者共同揭示不可绕过的冲突源头。
直接结论：破坏性更新不是 Composer 装错了，而是你的代码没适配新接口——必须查 UPGRADE.md、跑测试、用 composer why-not 定位阻断链，不能只看 composer update 输出的版本号。
为什么 composer update 不报错却运行时炸了
常见现象是本地 composer install 成功、phpunit 也过，但 CI 或部署后突然抛 Class not found、Call to undefined method 或 TypeError。这不是网络或权限问题，是 Composer 已成功安装新包，但你的代码仍调用已被移除/重命名/签名变更的方法。
- Monolog 3 移除了
StreamHandler::setFormatter()，但你的代码还在调 - Symfony 6 把
ContainerInterface::get()返回类型从object收紧为mixed，而你写了/** @var SomeService $service */强制断言 - cocur/slugify v4 要求
slugify()第二个参数必须是数组，v3 允许传null，你没改调用点
根本原因：很多包在 minor 版本（如 3.2 → 3.9）就引入 breaking change，且未严格遵守语义化版本；Composer 只管约束满足，不校验 API 兼容性。
怎么快速定位哪个包在“封杀”你
别猜，用 composer why-not 直接问谁在联合阻止目标版本。比如你想升 laravel/framework:^11.0 却失败，执行：
composer why-not laravel/framework:^11.0
输出会逐层列出所有阻断该版本的已安装包及其 require 约束。重点关注：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 是否含
require-dev包（如orchestra/testbench、phpunit/phpunit），它们常悄悄拉低主依赖版本 - 末尾是否出现
no installed package depends on—— 这说明冲突来自config.platform或根require的显式声明（比如你写了"php": "7.4"，但 Laravel 11 要求 PHP ≥ 8.2） - 加
--tree展开完整路径：composer why-not --tree vendor/package:version，看清是哪一层传递了不可妥协的限制
升级前必须做的三步验证
盲目 composer update 是高风险操作。先做最小范围验证：
- 跑
composer update --dry-run --with-dependencies vendor/package：只计算不写入，看是否仍冲突、影响哪些其他包 - 查
composer show vendor/package拿到 CHANGELOG 链接，重点盯 GitHub Release 页里的 “Breaking changes” 小节，或官方UPGRADE-*.md文档（比 CHANGELOG 更实操） - 临时建分支，
composer require vendor/package:desired-version --no-update+composer update --with-all-dependencies，把变更隔离出来跑完整测试套件
特别注意：如果测试套件没覆盖边界路径，composer update 后可能只在特定请求下才暴露 LogicException 或返回值类型变化（比如某方法原来返回 array，新版返回 Collection，但你用了 count()）。
冻结版本比硬扛 breaking change 更实际
不是所有 breaking change 都值得立刻跟进。尤其当你依赖的只是间接依赖（transitive dependency），且主业务没用到新特性时，冻结版本最省心：
- 在
composer.json的require里写死版本："monolog/monolog": "2.9.3"（不带^或~） - 若其他依赖强推更高版本（如
"some-lib": "^4.0"要求symfony/translation ^7.0），硬锁可能触发your requirements could not be resolved—— 此时得顺藤摸瓜查谁在推高依赖 - 慎用
replace：如"replace": { "symfony/translation-contracts": "*" }适合你已打补丁或替换成兼容实现，但易引发隐性冲突
真正容易被忽略的是 autoload 重建影响：升级后 vendor/autoload.php 重生成，可能因 PHP 版本限制跳过某些 PSR-4 映射（比如 v4 包要求 PHP ≥ 8.0，你还在 PHP 7.4），导致类存在却加载失败。验证方式：先 composer config platform.php 8.1，再 composer dump-autoload -vvv 看它是否跳过了目录。
