代理限制不会导致Composer镜像“同步不完整”，而是元数据请求失败后静默降级至过期缓存，表现为“包找不到”；根本原因是企业代理劫持HTTPS响应返回HTML而非JSON，需用curl -I验证Content-Type是否为application/json。
代理环境下 Composer 镜像“同步不完整”不是同步失败，而是元数据请求被静默降级到过期缓存——你看到的“包找不到”，大概率是代理劫持了 HTTPS 响应，返回 HTML 登录页却没报错。
curl -I 验证镜像源响应头是否被代理篡改
企业代理（如 Zscaler、SonicWall）常拦截 https://mirrors.aliyun.com/composer/ 这类域名，把 JSON 响应替换成 HTML 页面，而 Composer 不校验 Content-Type，直接解析失败后就放弃该源。
- 运行
curl -I -v https://mirrors.aliyun.com/composer/packages.json，检查响应头：必须含HTTP/2 200和Content-Type: application/json - 若返回
text/html、302跳转或403，说明代理在中间做了手脚 - 对比加
--noproxy "*"的结果：curl --noproxy "*" -I https://mirrors.aliyun.com/composer/packages.json；如果后者能正常返回 JSON，那代理就是根因
composer config -g http-proxy "" 清空全局代理配置
Composer 不读系统 NO_PROXY 环境变量，即使你设了 export NO_PROXY="mirrors.aliyun.com"，它也完全无视。必须显式清空或重设代理值。
- 彻底禁用代理：
composer config -g http-proxy ""（注意双引号不能省） - 若需局部代理（比如只走公司内网），设为真实地址：
composer config -g http-proxy "http://127.0.0.1:8888" - 验证是否生效：
composer config -g http-proxy应输出空行或你指定的地址，而非***或报错
composer diagnose 报 Connection failed 别信它
composer diagnose 默认只连 https://packagist.org，完全不查你配的镜像地址。它报错 ≠ 镜像不可用，只是说明本地 PHP 的 curl/SSL/时间配置可能异常，或者代理对官方源做了更激进的拦截。
- 真实验证方式只有两个：
curl -I https://mirrors.aliyun.com/composer/packages.json和composer config -g repo.packagist - 前者返回
200，后者输出完整 JSON（如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}），那diagnose的报错可直接忽略 - 常见干扰项：系统时间偏差 > 5 分钟会导致 TLS 握手失败，
curl也报错；先校准时间再排查代理
删错缓存目录等于白忙活：确认当前生效镜像路径再动手
Composer 把元数据缓存按镜像 URL 转义后存进 ~/.composer/cache/repo/ 下的子目录，比如 https---mirrors-aliyun-com-composer。代理若把请求改成了 https://internal-proxy.company.com/mirrors.aliyun.com/composer/，Composer 就会写进另一个路径，你删的可能是错的目录。
- 先查真实缓存位置：
composer config --global cache-dir - 再进
repo子目录看实际路径：ls -d $(composer config --global cache-dir)/repo/https---* - 确认后删除对应目录：
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer - Windows 用户路径类似：
%APPDATA%\Composer\cache\repo\https---mirrors-aliyun-com-composer
最易被忽略的是：镜像配置格式错误（比如少斜杠、键名多 s、缺 type）会导致静默回退官方源，且没有任何提示——所有排查都得从 composer config -g repo.packagist 输出是否为合法 JSON 开始。
