应执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/恢复有效镜像，需配合clear-cache、检查项目级repositories配置及环境变量，并验证curl -I返回200 OK。
Composer全局镜像配置被覆盖怎么办
淘宝镜像（https://mirrors.aliyun.com/composer/）早在2022年就已下线，现在执行 composer config -g repo.packagist 很可能返回空或指向一个 404 的旧地址。这不是你本地配置错了，而是源本身失效了——所有残留的淘宝镜像配置都会导致 composer install 卡在 “Loading composer repositories” 或直接报 Could not fetch https://mirrors.tuna.tsinghua.edu.cn/composer/... 404 类错误。
阿里云和腾讯云目前都维护着稳定、同步及时的 Packagist 镜像，但必须用它们当前有效的 URL，且需确认是否启用了 HTTPS 强制重定向（部分老教程里的 HTTP 地址会因 301 跳转失败）。
- 阿里云最新有效地址是：
https://mirrors.aliyun.com/composer/（注意是https，不是http） - 腾讯云最新有效地址是：
https://mirrors.cloud.tencent.com/composer/ - 清华源仍可用，但仅限国内高校网络环境；公网访问有时触发人机验证，不建议生产环境长期依赖
如何安全替换全局镜像而不影响项目私有配置
直接运行 composer config -g repo.packagist 只能查全局设置，但 Composer 会按“项目级 > 全局 > 默认”优先级合并配置。如果项目根目录有 composer.json 里写了 "repositories"，它就会屏蔽全局镜像——很多人换了全局却没生效，就是因为项目里硬编码了旧源。
- 先检查项目级是否干扰：
grep -A 5 '"repositories"' ./composer.json - 清空项目级自定义源（如确定不需要）：
composer config --unset repositories - 设置全局新镜像（以阿里云为例）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否写入成功：
composer config -g repo.packagist应输出{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
为什么 composer clear-cache 后仍拉不到包
缓存清理只是删掉本地 ~/.composer/cache/ 下的 zip 和 metadata，不影响源地址解析逻辑。真正卡住的原因常是 DNS 或 TLS 层问题：阿里云镜像域名需要正确解析，且部分企业网络会拦截非标准证书链的 HTTPS 请求。
- 手动测试源连通性：
curl -I https://mirrors.aliyun.com/composer/packages.json，应返回200 OK，而非301或超时 - 若 curl 报 SSL 错误，尝试临时关闭证书验证（仅调试）：
curl -kI https://mirrors.aliyun.com/composer/packages.json - 确认系统时间准确——TLS 握手失败常因本地时间偏差超过 5 分钟
- 某些 Docker 环境默认无 CA 证书包，需在容器内运行
apt-get update && apt-get install -y ca-certificates
CI/CD 流水线中避免镜像配置漂移
GitHub Actions、GitLab CI 等环境每次都是干净容器，composer config -g 写入的配置不会保留。硬编码镜像到每个 composer install 命令里又难维护。最稳的方式是用 Composer 的 -d 参数动态指定，或通过 COMPOSER_REPO_PACKAGIST 环境变量注入。
- 推荐 CI 中使用环境变量（兼容所有 Composer 版本）：
COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install - 或在
.gitlab-ci.yml中加：variables: COMPOSER_REPO_PACKAGIST: "https://mirrors.aliyun.com/composer/" - 避免在 CI 脚本里反复执行
composer config -g——不同 job 并行时可能写冲突，且无必要
镜像地址本身不复杂，但失效后排查路径容易绕远：先确认是源挂了，还是本地配置被覆盖，再看网络层是否拦了 HTTPS，最后才轮到 Composer 自身行为。别一上来就重装 Composer。
