composer升级major版本时直接composer update会失败，因为其默认遵循语义化版本约束，如"^2.0"等价于">=2.0.0
Composer升级major版本时为什么直接composer update会失败
因为Composer默认遵守语义化版本约束（如"monolog/monolog": "^2.0"），^2.0等价于>=2.0.0 ，它根本不会拉取<code>3.x——哪怕你手动改了composer.json，composer update也可能因依赖冲突卡住或回退。
常见错误现象：composer update monolog/monolog没反应、提示“Nothing to install or update”、或者报Conclusion: don't install monolog/monolog 3.0.0。
- 先确认当前约束：运行
composer show monolog/monolog看Installed和Latest版本，再查composer.json里该包的版本字符串 - 手动放宽约束：把
"^2.8"改成"^3.0"或更开放的"3.*"（不推荐"*"） - 加
--with-all-dependencies：否则Composer可能拒绝更新间接依赖，导致冲突 - 别跳过
--dry-run：先跑composer update monolog/monolog --dry-run看它打算装哪些包、删哪些、是否要降级其他包
升级后Class not found或Method not found怎么办
这是breaking change最典型的表象。比如Monolog 3移除了Monolog\Handler\StreamHandler::setFormatter()，改用构造器传入；Symfony 6把ContainerInterface::get()的返回类型从object收紧为mixed，触发严格模式报错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须查官方UPGRADE.md：每个major版本发布时，对应仓库根目录下都有
UPGRADE-3.0.md这类文件，它比CHANGELOG更实操 - 搜索代码里硬编码的类名/方法名：比如
grep -r "StreamHandler::setFormatter" . --include="*.php" - 注意命名空间变更：有些包（如
doctrine/annotations）在major升级中把Doctrine\Common\Annotations挪到Doctrine\Annotations，use语句全得改 - 别只测自己写的代码：第三方Bundle或插件可能还没适配，比如
symfony/debug-bundle在Symfony 6+已废弃，继续用会报Class "Symfony\Bundle\DebugBundle\DebugBundle" not found
如何让CI不被breaking change突然打脸
本地升级顺利不代表线上安全。Composer lock文件锁定的是精确版本，但CI每次composer install都基于这个lock，如果lock里还是旧版，升级就等于没发生。
-
composer.lock必须提交进Git：否则CI永远装不上你本地update后的结果 - CI流程里加检查：在
composer install后跑composer show --installed | grep "monolog/monolog"，确认装的是目标major版本 - 避免
composer update出现在CI脚本里：它不可重现，应只在开发机执行并提交新lock - 测试环境用
composer install --no-dev：防止phpunit等dev依赖的版本冲突掩盖主逻辑问题
为什么composer require有时悄悄降级其他包
当你运行composer require monolog/monolog:^3.0，Composer不仅要满足新包的约束，还要确保整个依赖图所有包仍能共存。如果现有psr/log是1.x，而monolog/monolog 3要求psr/log ^2.0，Composer只能把psr/log升到2.x——但如果另一个已安装包（如guzzlehttp/guzzle）还锁死在psr/log 1.1，Composer就可能强制降级guzzlehttp/guzzle到兼容psr/log 1.1的老版本，引发意料外的行为变更。
- 运行
composer why-not psr/log:^2.0快速定位谁在阻止升级 - 升级前先
composer prohibits psr/log:^2.0，看哪些包显式声明了冲突 - 对关键基础包（如
psr/*、symfony/polyfill）保持关注：它们的major变更常牵连极广，宁可晚升，别硬顶
最麻烦的不是升级动作本身，而是那些没写在文档里的隐式契约：比如某个包内部用了ReflectionClass::getMethods()遍历，而新版把方法改成了private，你的运行时反射逻辑就崩了——这种问题只能靠完整回归测试暴露，没有捷径。
