卡在Resolving dependencies是DNS问题,需先用dig验证解析、换DNS或检查hosts;卡在Downloading才调http.timeout或代理,且镜像配置须严格符合type=composer、URL末尾带/等规范。

连接超时不是 Composer 配置错了,是系统连通性断了——先别动 http.timeout,它对卡在 Resolving dependencies 阶段完全无效。
卡在 Resolving dependencies 是 DNS 问题,不是代理能救的
这一步只做域名解析(比如查 mirrors.aliyun.com 的 IP),不发 HTTP 请求、不读代理、不认超时设置。
- 运行
dig mirrors.aliyun.com @8.8.8.8,看是否返回有效 IPv4 地址;若超时或无响应,说明本地 DNS 被污染或不可用 - 临时换 DNS:Linux/macOS 编辑
/etc/resolv.conf加nameserver 8.8.8.8;Windows 在网络适配器里手动设 - 检查
/etc/hosts(或C:\Windows\System32\drivers\etc\hosts)是否误把mirrors.aliyun.com指向了127.0.0.1或错误 IP - 用手机热点试一次——很多企业网会屏蔽
packagist.org和 GitHub 域名,但热点通常直连通畅
卡在 Downloading 才该调 http.timeout 和代理
只有到这一步,Composer 才真正发起 HTTP 请求,此时 http.timeout 和 http.proxy 才起作用。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 全局延长超时:
composer config -g http.timeout 600(单位秒,600 = 10 分钟) - 项目级更稳妥(尤其 CI 环境):在
composer.json的"config"段加"http.timeout": 600 - 代理必须用
http.proxy配置项,不是https.proxy或其他别名:composer config -g http.proxy http://127.0.0.1:8080 - 带认证的代理 URL 格式为:
http://user:pass@127.0.0.1:8080,密码含特殊字符需 URL 编码
镜像源配置失败常静默不生效,必须严格验证
换源命令漏一个字符、少一个斜杠、类型写错,都会导致“看似成功”,实则完全不生效。
- 键名必须是
repo.packagist(注意repo是单数,不是repos) -
type值必须是composer,不能省略,也不能拼成compose - URL 必须是 HTTPS 且末尾带
/:https://mirrors.aliyun.com/composer/✅,https://mirrors.aliyun.com/composer❌(少斜杠会拼出非法路径/composerpackages.json) - 验证是否真生效:
composer config -g repo.packagist输出必须是完整 JSON,如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 换源后必须执行
composer clear-cache,否则旧缓存仍会复用失败地址
curl -I 验证镜像源是否可访问
即使配置正确,镜像站本身可能因维护、限流或证书过期返回 4xx/5xx 或 TLS 握手失败。
- 运行
curl -I https://mirrors.aliyun.com/composer/,确认返回HTTP/2 200或至少HTTP/1.1 200 - 若报
SSL certificate problem,说明 PHP 的curl.cainfo没配对,运行php --ini找真实加载的php.ini,再设curl.cainfo = "/path/to/cacert.pem" - 若返回
HTTP/1.1 403 Forbidden,可能是镜像站临时封了你的 IP 段,换https://mirrors.ustc.edu.cn/composer/试试
最易被忽略的是 composer.lock 文件里硬编码了旧源地址——哪怕你已切镜像、清缓存,只要不删 lock 文件,Composer 就会照着它重试失败路径。遇到反复超时,先 rm composer.lock vendor/ 再试。

















