composer require vendor/package:1.2.3常失败，因其本质是添加新依赖并触发全局sat求解，遇版本冲突即回滚；可靠做法是手动写死composer.json中版本号，再执行composer update package-name --with-dependencies强制局部重算。
直接改 composer.json 并跑 composer update package-name，别用 composer require 加版本号去硬塞。
为什么 composer require vendor/package:1.2.3 经常失败
这个命令本质是“添加新依赖”，Composer 会尝试把 1.2.3 融入现有依赖树，但不保证成功——尤其当已有包锁死了互斥版本时，它只会报 Conclusion: don’t install vendor/package 1.2.3 然后回滚 composer.json。
-
composer require默认启用 SAT 求解器，目标是找“全局可解路径”，不是“你想要哪个版本” - 加引号如
"vendor/package:^1.0"反而让 Composer 自行选一个“最新兼容版”，可能跳到你没测试过的1.9.0 - 如果包已被其他依赖间接引入（比如
laravel/framework带来了symfony/console），require会直接冲突，不给你机会干预
真正生效的版本锁定操作
要让某个包稳在指定版本，必须绕过“求解”，走“强制覆盖 + 局部重算”路径：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 手动编辑
composer.json，在require里写死版本："monolog/monolog": "2.9.3"（注意：不用^或~） - 立刻执行
composer update monolog/monolog --with-dependencies—— 这个参数强制它连同直系子依赖一起重算，避免只升父包、卡死子包 - 运行后马上
git diff composer.lock，确认只有monolog/monolog及其依赖被改，没波及其他包 - 如果仍失败，说明有其他包也强绑了冲突版本，此时用
composer prohibits monolog/monolog:2.9.3查谁在封杀
常见隐形冲突源：别忽略 require-dev
很多冲突其实来自开发依赖，比如 phpunit/phpunit 拖着老版 sebastian/exporter，间接锁死 symfony/console。这类问题不会出现在主 require 里，但一样阻塞安装。
- 运行
composer why-not monolog/monolog:2.9.3，如果输出为空，第一反应就是检查require-dev - 临时注释掉
require-dev区块，再试composer update，能快速验证是否是它导致的 - 测试工具类包（如
orchestra/testbench）经常绑定特定 Laravel 版本，和主项目不兼容时，必须降级或换镜像
降级跨主版本（如从 Guzzle 8 切回 7）的硬要求
跨主版本切换不能靠 ^7.0 这种模糊约束，Composer 不会自动退大版本——它只会在你声明的范围内找解。
- 必须在
composer.json中写死具体小版本："guzzlehttp/guzzle": "7.4.5" - 删掉
vendor/和composer.lock再composer install是无效动作，只会重跑失败逻辑 - 优先查 Packagist 上
guzzlehttp/guzzle的 tag 列表，确认7.4.5确实存在且支持你的 PHP 版本 - 代码里所有
GuzzleHttp\Client实例化、中间件写法都得兼容 v7 API，v8 的异步默认行为、Promise返回值等不能混用
最易被忽略的一点：composer.lock 不是快照，而是“已验证可行的依赖快照”。任何手动改 composer.json 后没跑 update 就直接 install，都会让 Composer 拒绝加载——它宁可报错也不用未验证的组合。
