Composer依赖冲突本质是约束无法同时满足，它只寻找满足所有要求的版本组合，找不到即报错；应优先用composer why-not定位阻断链、检查composer.lock中的实际版本，而非盲目清理或绕过校验。
依赖冲突时 composer update 卡住不动或报错
Composer 不会自动“解决”冲突，它只做一件事：按 composer.json 的约束找一组满足所有要求的包版本。一旦找不到，就直接报错，比如 Conclusion: don't install laravel/framework v10.32.0 这类信息——这不是 bug，是明确拒绝。
实操建议：
- 先运行
composer why-not vendor/package:version（如composer why-not guzzlehttp/guzzle:^8.0），它会列出阻断该版本的所有依赖链，比看报错更直觉 - 不要盲目删
vendor/或composer.lock，这会让问题更难复现；先用composer show vendor/package看当前实际安装的版本和它的 require 列表 - 如果冲突来自 dev 分支或
dev-main，注意 Composer 默认不启用minimum-stability降级，得显式加"minimum-stability": "dev"并配"prefer-stable": true来平衡
conflict 和 replace 字段的实际作用
这两个字段不是提示，是硬性规则：conflict 让 Composer 主动拒绝安装某组合，replace 则让 Composer 把一个包当另一个包的“替身”来处理——比如 symfony/polyfill-mbstring 在 replace 里声明替代 ext-mbstring，这样装了 polyfill 就算通过了对扩展的依赖检查。
常见错误现象：自己写的私有包加了 "conflict": {"laravel/framework": ">=11.0"}，但项目里没装 L11，却仍报冲突。原因往往是 conflict 是全局生效的，哪怕你没 require 它，只要其他已装包间接拉进来，就会触发。
实操建议：
-
conflict只用于强互斥场景（如两个包提供同一组 API 且不兼容），别用来“提醒用户注意版本”，那该用require或文档 -
replace后必须确保被替代项真能被完全覆盖，否则运行时出错——比如用mockery/mockery替换phpunit/phpunit的 mock 功能？不行，PHPUnit 的内部调用路径根本绕不开自己的实现
强制降级或跳过检查的危险操作
composer update --ignore-platform-reqs 看似能绕过 PHP 版本或扩展缺失的报错，但它只是关掉校验开关，不解决底层不兼容。比如在 PHP 8.1 上用 --ignore-platform-reqs 强装只支持 PHP 7.4 的包，大概率跑不起来。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
同理，composer require vendor/package:1.2.3 --no-update 再手动改 composer.lock，等于把依赖图交给运气管——Composer 不再验证一致性，下次 install 可能直接失败。
实操建议：
- 平台需求不满足？优先升级 PHP 或装扩展，而不是绕过；实在不行，用
platform-check: false配合 Docker 或 CI 环境隔离 - 需要临时测试旧版？用
composer require vendor/package:1.2.3 --with-all-dependencies，让 Composer 重新计算整条依赖链，而不是孤立地塞一个版本
私有仓库 + repositories 配置引发的隐性冲突
当 composer.json 里加了 repositories（尤其是 type: "package"），Composer 会把里面定义的包当作“已知源”参与依赖解析。如果私有包的 version 字段写成 "dev-master"，又没配 dist，Composer 可能反复尝试不同 commit，导致解析超时或选错版本。
更隐蔽的是：多个 repositories 定义了同名包（比如都叫 myorg/utils），Composer 默认只认第一个，后面那个完全被忽略——但你的 require 指向的却是第二个仓库里的版本，结果就是“明明写了却装不上”。
实操建议：
- 私有包优先用
type: "vcs"（Git URL），避免手写package类型；若必须用package，务必给version填语义化版本（如"1.0.0"），别用分支名 - 检查冲突时运行
composer config repositories，确认实际生效的仓库顺序；必要时用composer config --unset repositories.0临时移除干扰项
依赖冲突的本质是约束无法同时满足，不是工具不够智能。最常被忽略的点是：很多人花一小时调 composer.json，却没打开 composer.lock 看一眼真正锁死的版本组合——那里才藏着真实世界跑起来的唯一解。
