Composer依赖解析失败的典型原因是composer.json中版本约束冲突，如A包要求monolog:^2.0而B包锁定^1.25，应通过composer install -vvv定位“Problem 1”并检查PHP扩展与版本实际配置。
报错信息里有 “Your requirements could not be resolved”
这是 Composer 依赖解析失败的典型提示，不是网络问题，而是 composer.json 里写的版本约束互相打架了。比如 A 包要求 monolog/monolog:^2.0，B 包却锁死要 ^1.25，Composer 就没法选一个同时满足两者的版本。
- 先别急着删
composer.lock或跑composer update——这会放大冲突 - 用
composer install -vvv看完整报错链，重点找 “Problem 1” 后面那几行，它会明确指出哪个包、哪个扩展、哪个 PHP 版本不满足 - 常见诱因：某个包依赖
ext-pcntl（如laravel/horizon），但 CLI 模式下 PHP 没启用；或要求ext-dom（如phpunit/php-code-coverage），而你只装了 Apache 模块没配 CLI - 临时绕过平台限制可加
--ignore-platform-reqs，但仅限调试——它跳过 PHP 版本和扩展检查，装完可能运行时报错
卡在 “Loading composer repositories” 或超时
这基本是网络层问题，Composer 默认直连 GitHub 和 Packagist，国内环境常被 DNS 污染或 TLS 握手失败，和你本地 PHP 配置无关。
- 立刻切阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 如果仍卡住，大概率是 CA 证书失效导致 HTTPS 验证失败，检查
php.ini是否设置了curl.cainfo，路径是否指向有效的cacert.pem（推荐从curl.se/ca下最新版） - 企业网或代理环境需额外配置：
composer config -g http-proxy http://your-proxy:port，否则所有请求都会挂起 - 弱网下记得调高超时：
composer config -g process-timeout 3000和composer config -g http-timeout 600
执行 composer install 提示 “Command not found” 或 “Could not open input file”
这不是 Composer 没装好，而是命令找不到 composer.phar 文件，本质是系统 PATH 没生效或路径写错了。
- 确认安装位置：运行
which composer（macOS/Linux）或where composer（Windows），看是否返回有效路径 - 如果返回空，说明没加进环境变量——Linux/macOS 执行
sudo mv composer.phar /usr/local/bin/composer；Windows 则手动把composer.phar放到%PROGRAMFILES%\Composer\并把该路径加入系统PATH - 改完环境变量后，新开终端再试，旧终端不会自动 reload
- 别长期用
php composer.phar install代替composer install，IDE、CI 脚本和 Laravel Mix 等工具都认不到这个写法
删了 vendor 和 composer.lock 还是装不上
这时候问题往往藏得更深：缓存损坏、PHP 扩展缺失、或某些包本身已弃用。盲目重试只会重复失败。
- 先清缓存：
composer clear-cache，它清理的是~/.composer/cache下的 zip 和 metadata，不是项目级的 - 检查 CLI 模式 PHP 实际加载的
php.ini：php --ini，然后用php -m确认curl、openssl、mbstring、zip全开着——XAMPP/MAMP 用户最容易搞混 Apache 和 CLI 的 ini 文件 - 如果错误里反复出现某个包（如
jpush/jpush），可能是 packagist 上已移除或重命名，去官网查最新包名，或加--ignore-platform-reqs强制装（仅限验证） - 最后手段：用
composer install -vvv --no-plugins --no-scripts关掉插件和脚本，排除第三方干扰
最常被忽略的一点：报错里提到的 PHP 版本或扩展，必须是 php -v 和 php -m 在终端里实际输出的，而不是你以为“XAMPP 控制面板上显示的那个”。CLI 和 Web Server 的 PHP 配置完全独立，这点不确认清楚，所有操作都是在原地打转。
