答案:Composer全局代理配置无效主因是环境变量HTTP_PROXY/HTTPS_PROXY优先级更高且大小写敏感,或代理地址末尾斜杠、认证格式错误、putenv()被禁用;需用composer global status或-vvv抓请求验证真实生效。

全局代理配置写进去了,但 composer install 依然连不上,甚至报 cURL error 7 或卡在 Resolving dependencies —— 这不是代理地址错了,而是代理没被真正用上,或被其他配置覆盖了。
为什么 composer config -g http-proxy 看起来成功却无效
它只改配置文件,不验证连通性;更关键的是,环境变量 HTTP_PROXY/HTTPS_PROXY 优先级高于配置项,且大小写敏感(Linux/macOS 下 http_proxy 不生效,必须大写)。常见静默失效点:
- 终端里设置了
export http_proxy=...(小写),Composer 忽略它 - 代理地址末尾带斜杠:
http://127.0.0.1:7890/→ 解析失败,必须去掉 - 代理需要认证,但配置里漏了
user:pass@,请求卡在 DNS 解析后、TLS 握手前,无明确报错 - PHP 禁用了
putenv()(见php.ini中disable_functions),composer config -g实际没写进配置文件,但也不报错
怎么确认代理真在转发流量
别信 composer diagnose 里那句 HTTP proxy: [none] —— 它只读配置,不发包。要触发真实请求:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 运行
composer global status:成功返回OK表示 HTTPS 请求能经代理抵达 Packagist 元数据接口 - 运行
composer show --platform -vvv 2>&1 | grep "GET https":看实际发出的请求 URL 是否走你配的代理地址 - 抓包验证最准:开 Wireshark 或
tcpdump,过滤目标端口(如port 7890),确认有出向连接
局部配置如何绕过全局代理干扰
项目级 composer.json 中的 config.http-proxy 会覆盖全局设置,适合临时禁用代理或切不同出口。但注意:
- 局部配置只影响当前项目,不会污染全局;但若项目里已有
"repositories"字段(哪怕空数组[]),全局镜像配置repo.packagist就完全失效 - 想彻底隔离:在项目根目录执行
composer config http-proxy ""(清空局部代理),再用COMPOSER_HTTP_PROXY="" composer install临时关闭 - CI 场景更稳妥:直接用环境变量传参,比如
COMPOSER_HTTP_PROXY=http://proxy:8080 composer install,避免配置文件残留风险
代理失效时最简回退路径
当调试陷入僵局,优先做三件事,比反复改配置更快定位问题:
- 删缓存:
composer clear-cache(旧packages.json可能还记着失败的域名) - 删锁文件:
rm composer.lock(避免composer.lock里固化了原官方 dist URL) - 强制跳过缓存重试:
composer install --no-cache -vvv 2>&1 | grep "Downloading",看第一行请求是否匹配你的镜像或代理地址
代理配置的“生效”不是写完就结束,而是每一步都得对应到真实网络请求上;最容易被忽略的是环境变量优先级和认证凭据的拼写细节——少一个 @,整个流程就静默卡死在 TLS 握手阶段。

















