Composer更新失败主因是网络或镜像源配置问题，需先用curl验证代理链路、检查DNS及直连状态，再显式配置Composer代理（config -g http-proxy），并确认diagnose显示代理已启用。
Composer 更新代理节点失败，90% 是本地网络出口或镜像源配置问题，不是 Composer 本身坏了。 直接改 composer.json 或硬切国内镜像源常治标不治本——得先确认真实网络路径是否通、代理是否生效、DNS 是否污染。
怎么快速判断是代理没走通还是镜像源挂了
别急着换源或重装 Composer。先用最底层命令验证代理链路：
- 运行
curl -v https://packagist.org/packages.json，看实际请求的 IP 和响应时间；如果超时或返回 403/503，说明出口网络或代理策略拦截了 - 加代理再试：
curl -x http://127.0.0.1:7890 -v https://packagist.org/packages.json（把7890换成你本地代理端口），观察是否成功建立 CONNECT 隧道 - 如果代理下能通但
composer update不行，大概率是 Composer 没读取系统代理环境变量——它默认不继承 shell 的http_proxy，得显式配置
Composer 代理必须显式设置，不能靠系统环境变量
Composer 从 2.0 开始默认忽略 http_proxy 等系统变量，必须用 config 命令写入全局或项目级配置：
- 全局设代理（推荐）：
composer config -g http-proxy http://127.0.0.1:7890 - 关 HTTPS 代理校验（常见报错
SSL certificate problem）：composer config -g secure-http false（仅调试用，上线前务必关掉） - 验证是否生效：
composer config -g http-proxy应输出你刚设的地址；composer diagnose会提示 “HTTP proxy support is enabled” - 注意：如果用了 socks5 代理（比如 Clash 的
socks5://127.0.0.1:7891），Composer 原生不支持，得换 http 代理端口或用proxychains包裹命令
一键自测脚本：网络 + 代理 + 镜像源三连查
把下面这段保存为 composer-net-check.sh，chmod +x 后直接运行，5 秒内出结果：
#!/bin/bash
echo "=== 当前代理配置 ==="
echo "http_proxy: $http_proxy"
echo "https_proxy: $https_proxy"
echo -e "\n=== DNS 解析 packagist.org ==="
dig +short packagist.org | head -1
echo -e "\n=== 直连测试（无代理）==="
curl -s -o /dev/null -w "%{http_code}\n" -m 5 https://packagist.org/packages.json
echo -e "\n=== 代理测试（假设端口 7890）==="
curl -x http://127.0.0.1:7890 -s -o /dev/null -w "%{http_code}\n" -m 5 https://packagist.org/packages.json
echo -e "\n=== Composer 自身配置 ==="
composer config -g http-proxy 2>/dev/null || echo "未设置"
composer diagnose 2>&1 | grep -E "(HTTP|secure-http)"
关键看三行：直连是否返回 200、代理是否返回 200、composer diagnose 是否显示代理已启用。三项中任一失败，就卡在对应环节。
真正麻烦的不是配错参数，而是代理进程监听了 127.0.0.1 却没监听 localhost，或者防火墙拦了 loopback 流量——这种问题不会报错，只会静默超时。
