解决Composer install报错的极简指南-composer-PHP中文网

答案是“connection refused”或“curl error 7”属系统级连通失败，需先验证dns（ping packagist.org）、确认镜像生效（composer config -g repo.packagist输出完整json）、清缓存（composer clear-cache）、排除代理与权限干扰。

解决composer install报错的极简指南

报错里带“Connection refused”或“cURL error 7”

这不是 Composer 没配好，是系统根本连不出去。DNS 解析失败、防火墙拦截、代理策略冲突，都卡在这一步。

先跑 ping packagist.org：返回 unknown host 就说明 DNS 不通，不是换镜像能解决的
确认镜像已生效：composer config -g repo.packagist 必须输出完整 JSON，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null 或仍是 packagist.org，说明配置压根没写进去
换源后必须清缓存：composer clear-cache，否则旧失败记录还在，重试照样走原地址
企业内网若走中间人代理，会静默触发连接拒绝；临时验证可加：composer config -g secure-http false 和 composer config -g cafile /dev/null（仅调试用）

卡在 “Downloading” 但日志没出现镜像域名

说明 Composer 根本没走你配的镜像，而是 fallback 到了官方源，或者被项目级配置覆盖了。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

真实请求地址只看这一行：composer install -vvv 2>&1 | head -n 10 | grep Downloading，第一行 URL 才算数
检查项目根目录 composer.json 是否含 "repositories" 字段：哪怕只是 [] 或 {}，也会完全屏蔽全局镜像
删掉整个 "repositories" 区块（注意保留逗号和缩进），再运行 composer clear-cache，最后 composer update --lock 刷新锁文件里的 dist URL
CI/CD 或宝塔环境常见问题：你用 root 配的全局镜像，但构建脚本以 www 用户运行——得用 sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

报 “Your requirements could not be resolved”

这不是依赖冲突，是你本地环境不满足 composer.lock 的硬性前提。

查 PHP 版本：php -v，对比 composer.lock 里 platform.php 或包的 require.php 字段（比如某包要求 php >=8.1，而你本地是 8.0）
检查扩展是否启用：php -m | grep -E "(mbstring|xml|curl|zip|openssl)"，缺哪个就装哪个
composer.json 顶部 "config": {"platform": {}} 写死了平台版本，但和实际不符（例如写 "php": "8.2.10" 却在 8.1 下执行）
--ignore-platform-reqs 是临时绕过手段，不是解决方案；加了它装出来的包大概率运行时报错

报 “Permission denied” 写 vendor/ 或 composer.lock

90% 不是权限不够，是目录“认错了主人”——vendor/、composer.lock 或 ~/.composer 被 sudo 污染过，属主是 root，而你正以普通用户运行命令。

看报错路径：file_put_contents(/path/to/vendor/autoload.php): Permission denied → 问题就在 vendor/
立刻检查归属：ls -ld vendor/ composer.lock $(composer config --global home)
修复归属：sudo chown -R $USER:$USER vendor/ composer.lock ~/.composer（别用 chmod 777，那只会埋雷）
永远不要用 sudo composer global require，它会把二进制文件装进 /root/.composer，普通用户 shell 找不到

缓存残留、镜像 URL 缺斜杠、repositories 字段干扰、PHP 平台声明与实际不符——这些点不手动验证，光靠重试或换源，只会反复撞在同一堵墙上。