必须先执行 composer config platform.php 7.4.0 锁定解析平台版本，再用 composer why 和 prohibits 定位冲突依赖，最后通过 --dry-run -vvv 查看 SAT 求解器真实报错并分阶段清理重解析。
PHP 7.4 项目在运行 composer install 或 composer update 时突然报错“Your requirements could not be resolved”，提示依赖无法满足，而你确认 PHP 版本是 7.4、composer.json 也没手动改坏——这说明 Composer 在解析过程中发现了隐性冲突，必须从环境、约束、锁文件三层面交叉验证才能定位根因。
第一步：确认 Composer 解析时“看到”的 PHP 版本
Composer 不读取你终端里 php -v 的输出，而是按自身规则判断可用 PHP 环境。若你本地是 PHP 7.4，但 Composer 错误地按 PHP 8.x 解析依赖，就会拒绝所有仅支持 7.4 的包（如 paragonie/random_compat v9 已弃用，v10 要求 PHP 8.0+）。
执行：composer config --list | grep platform
若输出中没有 config.platform.php 行，或值不是 7.4.0，Composer 就会用当前系统 PHP 版本（可能被 alias 或 update-alternatives 修改过）做解析——这极易导致误判。此时需强制锁定：
立即学习“PHP免费学习笔记（深入）”；
composer config platform.php 7.4.0
该命令会写入 composer.json 的 config → platform → php 字段，【这是解决 PHP 7.4 项目冲突最常被忽略的前提】。不加这行，后续所有排查都可能白费。
第二步：用 why 和 prohibits 定位冲突源头
不要直接删 composer.lock 或盲目降级包——先搞清谁在拉扯。
方法一：查某个已安装但引发问题的包为何存在composer why monolog/monolog
它会列出所有直接或间接要求该包的上游依赖。如果某行显示 your/project → some/package → monolog/monolog:2.10，而你的项目 composer.json 明确写了 "monolog/monolog": "^1.25"，说明 some/package 是冲突发起者。
方法二：查哪个包阻止了你想装的版本composer prohibits monolog/monolog:1.25.0
这条命令会直接打印出所有与 1.25.0 冲突的包及其约束条件。输出类似：laravel/framework v8.75.0 requires monolog/monolog ^2.0——这就暴露了 Laravel 8 强制要求 Monolog 2.x，而你硬要 1.x，冲突根源立刻清晰。
第三步：分阶段清理与重解析
① 清除 Composer 缓存，避免旧元数据干扰：composer clear-cache
② 删除 vendor 目录和 composer.lock（注意：仅当确认 lock 文件已损坏或多人协作中 merge 出错时才删 lock；否则跳过此步，直接走第③步）
③ 执行带详细日志的模拟安装，观察卡点：composer update --dry-run -vvv
-vvv 会输出 SAT 求解器每一步尝试的包组合，最终在末尾给出类似 Root problem: monolog/monolog 1.25.0 requires php >=5.6.0 but your PHP version (7.4.33) does not satisfy that requirement 的真实报错——注意这里写的 PHP 版本是 Composer 实际采用的平台版本，和你终端 php -v 可能不同。
④ 若上步发现某包（如 guzzlehttp/guzzle）反复出现在冲突链中，可临时移除它再试：composer remove guzzlehttp/guzzle
再运行 composer update --dry-run。若不再报错，说明它是关键冲突节点，需查其最新兼容 PHP 7.4 的版本（如 ^7.4），而非盲目装 ^8.0。
