Composer中文镜像解决由于镜像站维护导致同步失败的方案-composer-PHP中文网

答案是镜像源临时下线或dns解析异常导致，应先用curl测试当前镜像可达性，再快速切换至华为云、腾讯云或清华源等备用镜像，并确保配置命令含composer类型及末尾斜杠。

composer中文镜像解决由于镜像站维护导致同步失败的方案

Composer install 时提示 `Connection refused` 或 `Could not resolve host`

这类错误通常不是本地网络问题，而是当前配置的镜像源（比如阿里云、腾讯云或华为云镜像）临时下线或 DNS 解析异常。Composer 不会自动 fallback 到其他镜像，它只认 composer config -g repo.packagist 里存的那个地址。

实操建议：

先运行 composer config -g repo.packagist 确认当前全局镜像地址；
用 curl -I https://mirrors.aliyun.com/composer/ 测试该地址是否可访问（注意：有些镜像站关闭了根路径响应，但 /packages.json 可能仍有效，所以建议测 curl -sS https://mirrors.aliyun.com/composer/packages.json | head -n1）；
如果不可达，立刻切到备用镜像——别等“官方通知”，镜像维护通常不发公告。

快速切换到可用镜像的命令组合

不用查文档、不用改配置文件，一条命令重置为国内主流备选之一：

切华为云（目前稳定性较高）：composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/

切腾讯云：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

切清华源（适合教育网用户）：composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/

注意：composer 后面必须跟 composer（表示类型），不能漏掉；路径末尾斜杠不能省，否则部分版本会静默失败。

为什么 `composer global require` 有时不受镜像配置影响

因为全局包（如 hirak/prestissimo 或 phpstan/phpstan）安装时，Composer 会读取全局配置，但某些插件或旧版 Composer（

解决方法：

升级 Composer：composer self-update（至少 2.2+ 更可靠）；
加 -vvv 参数看实际请求 URL，确认是否真走了镜像；
临时强制指定镜像：composer global require hirak/prestissimo --repository=https://mirrors.tuna.tsinghua.edu.cn/composer/。

CI/CD 环境中避免镜像单点故障

GitHub Actions、GitLab CI 里写死一个镜像地址，一旦那个站挂了构建就全崩。更稳妥的做法是用脚本探测 + fallback：

#!/bin/bash
MIRRORS=(
  "https://repo.huaweicloud.com/repository/php/"
  "https://mirrors.tuna.tsinghua.edu.cn/composer/"
  "https://mirrors.cloud.tencent.com/composer/"
)
for url in "${MIRRORS[@]}"; do
  if curl -sfL "$url/packages.json" >/dev/null; then
    composer config -g repo.packagist composer "$url"
    echo "Using mirror: $url"
    break
  fi
done

这个逻辑比「试一个、失败就报错」强得多。真正上线前，得验证 packages.json 而非只测 HTTP 状态码——有些镜像返回 200 却是 HTML 页面（比如维护页），那照样装不了包。