Composer 报“Your requirements could not be resolved”时，需按五步排查：一、用 composer update --dry-run -vvv 查冲突详情；二、修正 composer.json 中不稳定版本约束；三、用 composer why/why-not 分析依赖链；四、显式指定兼容版本并加 --with-all-dependencies；五、配置 minimum-stability 和 prefer-stable。
如果您在执行 composer install 或 composer update 时遇到 “Your requirements could not be resolved” 报错，这表明 Composer 无法为项目中声明的所有依赖项找到满足全部约束条件的版本组合。以下是排查和解决该问题的具体操作步骤：
一、查看详细的冲突信息
Composer 默认报错较简略，需启用详细模式以获取具体不兼容的包名与版本约束。该步骤用于准确定位冲突源头，避免盲目调整依赖。
1、在项目根目录下运行命令：composer update --dry-run -vvv
2、观察终端输出中包含 "Conclusion: don't install" 或 "Problem 1" 的段落，重点关注被拒绝安装的包及其版本范围。
3、记录下冲突涉及的包名（如 guzzlehttp/guzzle）、当前锁文件中已安装的版本、以及新要求的版本约束（如 ^7.0 与 ^8.0 冲突）。
二、检查 composer.json 中的版本约束写法
宽松的版本约束（如 *、dev-main、@dev）或过时的固定版本易引发解析失败。应优先使用语义化版本范围，并避免混合使用不稳定标记。
1、打开项目根目录下的 composer.json 文件。
2、查找所有含 "dev-"、"*" 或 "@dev" 的 require 或 require-dev 条目。
3、将不稳定约束替换为明确的稳定范围，例如将 "guzzlehttp/guzzle": "dev-master" 改为 "guzzlehttp/guzzle": "^7.5"。
4、保存文件后，删除 composer.lock 文件及 vendor/ 目录。
三、使用 composer why 和 composer prohibits 分析依赖链
这两个命令可揭示某个包为何被安装（或禁止安装），帮助识别间接引入的冲突依赖，尤其适用于由子依赖引发的版本锁定问题。
1、若怀疑某包（如 symfony/console）导致冲突，运行：composer why symfony/console
2、若某包被明确拒绝安装（如 laravel/framework:9.0），运行：composer prohibits laravel/framework:9.0
3、根据输出结果，定位到哪个顶层依赖或子依赖强制指定了不兼容版本，并针对性调整其版本号。
四、临时降级或升级特定依赖以绕过冲突
当确认某依赖的特定版本是冲突核心时，可显式指定一个中间兼容版本，使 Composer 能达成一致解。此方法不改变功能逻辑，仅调整版本选择空间。
1、根据步骤一中识别出的冲突包（如 illuminate/support），运行：composer require illuminate/support:^8.75
2、若提示该包已被其他依赖锁定，添加 --with-all-dependencies 参数：composer require illuminate/support:^8.75 --with-all-dependencies
3、执行完成后，再次运行 composer update 验证是否成功生成 lock 文件。
五、启用最小稳定性与 prefer-stable 配置
项目中混用稳定版与开发版依赖时，Composer 可能因默认稳定性策略无法收敛。通过配置可强制优先选择稳定版本，缩小可行解空间。
1、在 composer.json 的根对象中添加或修改字段：
"minimum-stability": "stable",
"prefer-stable": true
2、确保所有 require 条目未显式标注 @dev 或 @RC 等低稳定性标记。
3、保存后清除 vendor 和 lock 文件，重新执行 composer update。
