腾讯云Composer镜像已下线，自2024年10月1日起https://mirrors.cloud.tencent.com/composer/返回404，所有配置均失效；应立即切换至阿里云（https://mirrors.aliyun.com/composer/）或华为云镜像，并清缓存、检查项目级repositories覆盖。
腾讯云 Composer 镜像已下线，https://mirrors.cloud.tencent.com/composer/ 自 2024 年 10 月 1 日起返回 404，所有基于该地址的配置均失效。现在强行配置或沿用旧教程，只会导致 Connection refused、SSL certificate problem 或卡在 Loading composer repositories。
为什么 composer config -g repo.packagist 看似成功却没用？
这不是命令写错了，而是镜像服务本身已不可达。Composer 会尝试请求 https://mirrors.cloud.tencent.com/composer/packages.json，但该地址已永久下线——DNS 可能解析成功，但 HTTP 层直接 404；PHP 8.2+ 和 Composer 2.7+ 还会因 HTTPS 校验失败而中断，不会静默回退。
-
repo.packagist键名、composertype、末尾/全都正确，也救不了一个已关停的源 - 执行
composer config -g repo.packagist可能仍输出旧 URL，但这只是配置残留，不代表可用 - 验证是否真生效，必须运行
composer show -p | head -3，看实际发起的请求域名是否含cloud.tencent.com—— 现在只会看到失败日志
当前可立即切换的替代方案（阿里云 / 华为云）
别修、别试、别等“恢复”，直接切到仍在维护的国内源。推荐优先使用阿里云，同步稳定、兼容性好、公网访问无策略拦截风险：
腾讯云跨账号资源迁移
下载
腾讯云跨账号资源迁移工具，支持将账号A的VPC、CLB、NAT、CVM、安全组等资源迁移至账号B，通过CCN云联网实现跨账号网络互通，提供自动扫描、配置生成、Terraform部署功能。
- 清掉无效配置：
composer config -g --unset repos.packagist（注意是repos.packagist，不是repo.packagist；这是为兼容旧版残留） - 设阿里云源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（URL 末尾/不可省） - 强制清缓存：
composer clear-cache（否则仍会从本地缓存读取指向腾讯云的元数据） - 验证：
composer config -g repo.packagist应输出完整 JSON；再跑composer install -vvv，确认请求 URL 含aliyun.com
项目级配置覆盖全局时怎么处理？
即使全局配了新源，只要项目 composer.json 里有 repositories 字段（尤其是显式写了 "packagist.org"），就会彻底屏蔽全局设置。这是最常被忽略的覆盖点。
- 检查是否被覆盖：
composer config -l | grep repositories.packagist，若为空或仍显示腾讯云/官方地址，说明项目级生效 - 安全修改项目配置（不删私有源）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 若项目需保留私有仓库，又想加镜像，不要手动编辑 JSON；用上述命令会自动 merge 进
repositories对象，保持结构合法
镜像不是一劳永逸的基础设施——阿里云和华为云也可能在未来调整策略或同步延迟，建议在 CI 流程中加入 composer diag 检查源连通性，并把 composer clear-cache 当作换源的必选项，而非可选步骤。
