腾讯云 Composer 镜像已下线,自2024年10月1日起失效;应切换至阿里云(https://mirrors.aliyun.com/composer/)或华为云(https://repo.huaweicloud.com/php/)等可用源,并清缓存、删composer.lock和vendor、检查项目级repositories覆盖。

腾讯云 Composer 镜像源已停止服务,当前无法使用。2024 年 10 月 1 日起,https://mirrors.cloud.tencent.com/composer/ 返回 404,所有基于该地址的配置均失效。继续尝试配置或验证,只会浪费时间在无效路径上。
为什么 composer config -g repo.packagist 看似成功却没用
这条命令本身语法正确,但执行后仍走 packagist.org,根本原因不是你输错了,而是镜像服务已下线。Composer 2.5+ 在请求失败时会静默回退到官方源,不报错、不提示、不中断——你看到 composer config -g repo.packagist 输出了 JSON,只说明配置写进去了,不代表它能连通。
-
composer diagnose显示Repo.packagist.org: OK?那是假阳性——它检测的是“配置项存在且格式合法”,不是“镜像地址可访问” -
composer require monolog/monolog -vvv日志第一行若仍是https://packagist.org/packages.json,就坐实了没走通 - 即使你用
dig mirrors.cloud.tencent.com +short查到 IP,请求也会在 CDN 层返回 404,不是 DNS 或本地网络问题
当前可用的国内镜像源(2026 年实测有效)
别再查“腾讯云怎么配”,直接切到仍在维护的源。以下三个地址截至 2026 年 8 月中旬全量同步、HTTPS 正常、无证书错误:
- 阿里云:
https://mirrors.aliyun.com/composer/(路径末尾必须带/) - 华为云:
https://repo.huaweicloud.com/php/(注意是/php/,不是/composer/) - Coding 自建镜像(需自行部署):
https://<your-namespace>.pkg.coding.net/<project>/composer</project></your-namespace>
切换时务必用完整命令,漏掉 type 值或斜杠都会静默失败:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
换源后仍慢或失败,先清这三样
缓存、锁文件、项目级配置,三者任一残留都可能让新镜像形同虚设:
- 运行
composer clear-cache:清除本地p2/元数据缓存,否则 Composer 仍按旧索引发起请求 - 删除
composer.lock和vendor/:否则composer install直接复用 lock 文件里的旧 URL - 检查项目根目录下
composer.json是否含"repositories"字段:若有,删掉或确认其内容不是"url": "https://packagist.org",否则它会强制覆盖全局设置
镜像不是一劳永逸的配置。国内源每年都有关停或策略变更,比如腾讯云、PHPComposer、网易等旧源均已退出。真正可靠的方案,是在 CI 流程里加一步 composer diagnose | grep -q "OK",并把镜像 URL 设为可配置变量,而不是硬编码进脚本里。











