“your requirements could not be resolved”是依赖冲突而非网络问题，表明composer已成功获取元数据但无法找到满足全部约束的版本组合，需用composer why-not定位拦路包，并检查composer.json硬编码版本、php环境及镜像配置。
报错里带“Your requirements could not be resolved”？这是依赖逻辑冲突，不是网络问题
这个错误说明 Composer 已成功连上镜像、下载完所有元数据，但在本地解依赖时发现没有一组版本能同时满足全部约束。它和网速、镜像、权限完全无关。
- 立刻运行
composer why-not加上你想装的包和版本，比如composer why-not phpunit/phpunit:^10.0，输出会直接告诉你哪个已有包在拦路（例如laravel/framework v9.52.5 requires nunomaduro/collision ^6.0） - 检查
composer.json里有没有写死版本号，比如"monolog/monolog": "2.9.0"—— 这种硬编码极易和新包的^3.0冲突 - 别用
--ignore-platform-reqs硬过，它只是跳过校验，上线前仍得修复；真要绕过，优先改目标包的版本约束（如降级到^9.6），而非升级整个生态 - 确认 PHP CLI 版本真实可用：
php -v和php -m | grep -E "mbstring|openssl|curl"，Web 页面显示的 phpinfo() 和 CLI 加载的 php.ini 常不一致
卡在 “Loading composer repositories” 或 “file could not be downloaded”？八成是镜像没配对或缓存污染
国内直连 packagist.org 几乎必然失败，但换源后仍卡住，往往因为配置漏了关键细节，或旧缓存还在误导 Composer。
- 验证全局镜像是否真写进去了：
composer config -g repo.packagist输出必须是完整 JSON 对象，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null或仍是https://packagist.org，说明根本没配成功 - 三个硬条件缺一不可：键名必须是
repo.packagist（不能是repos.packagist）、type必须显式传composer、URL 必须 HTTPS 且末尾带/（https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌） - 切源后必须清缓存：
composer clear-cache；Windows 用户还得手动删%LOCALAPPDATA%\Composer\cache - 项目根目录若存在
"repositories": []或任何repositories字段，全局镜像会彻底失效——此时应进项目目录执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g）
Permission denied 写 vendor/ 或 composer.lock？大概率是目录被 root 污染过
报错里明确写了路径，比如 file_put_contents(/path/to/vendor/autoload.php): Permission denied，那就直接去查那个路径的属主，不是改 chmod，而是修 ownership。
- 运行
ls -ld vendor/ composer.lock $(composer config --global home)，看输出里是不是一堆root；只要有一个是 root，后续普通用户就写不了 - 修复命令：
sudo chown -R $USER:$USER vendor/ composer.lock ~/.composer（Linux/macOS）；Windows 上对应清理%LOCALAPPDATA%\Composer目录权限 - 安装 Composer 本身也容易踩坑：
curl | sudo php是无效提权，右边 php 进程仍以当前用户运行；正确做法是sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer，或更稳妥地装到$HOME/bin并加进$PATH - CI/CD 或宝塔环境特别注意：你用 root 配的全局镜像，但实际跑命令的是
www用户，得用sudo -u www composer config -g repo.packagist ...单独配
SSL 错误、404 或 JSON decode error？根源常在 CA 证书或镜像元数据损坏
这类错误看似网络层问题，实则是 PHP 的 curl/cainfo 指向了过期证书，或 Composer 拿着旧 lock 文件里的路径去新镜像上找不存在的东西。
- 运行
php --ini找到真实加载的php.ini，在里面设置curl.cainfo = "/path/to/cacert.pem"和openssl.cafile = "/path/to/cacert.pem"；证书文件从https://curl.se/ca/cacert.pem下载 - 删掉
vendor/和composer.lock再重试——composer.lock里硬编码了 provider 地址，不清它，Composer 就一直重试失败路径 - 手动验证镜像可用性：
curl -I https://mirrors.aliyun.com/composer/packages.json必须返回HTTP/2 200；若返回 HTML 页面（如人机验证），说明该镜像不适合自动化场景 - 某些 “PHP 语法错误” 报错（如
Only variables should be passed by reference）其实是镜像返回了乱码或 BOM 头，换阿里云/腾讯云源即可
