腾讯云Composer镜像源已于2024年10月1日下线，https://mirrors.cloud.tencent.com/composer/返回404，配置必失败；应清除旧配置、设置阿里云镜像（https://mirrors.aliyun.com/composer/）、并验证URL含aliyun.com。
腾讯云 Composer 镜像源已于 2024 年 10 月 1 日正式下线，https://mirrors.cloud.tencent.com/composer/ 现返回 HTTP 404，任何尝试配置该地址的行为都会失败——这不是你命令写错了，而是服务端已不可用。
为什么 composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ 一定报错
执行这条命令会直接失败，常见表现包括：
-
Could not fetch https://mirrors.cloud.tencent.com/composer/packages.json（404） -
SSL certificate problem: unable to get local issuer certificate（HTTPS 校验失败后 Composer 2.7+ 不再静默回退） -
Invalid repository type（部分版本因重定向异常触发协议校验失败）
根本原因：镜像服务已下线，不是网络、代理或缓存问题。继续尝试腾讯云地址只会浪费时间。
如何安全切换到仍在维护的国内镜像（推荐阿里云）
必须三步并行，缺一不可：
- 先清除残留配置：
composer config -g --unset repos.packagist（注意是repos.packagist，不是repo.packagist；拼错键名会导致旧无效配置残留） - 再设新源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（末尾/不可少） - 最后验证生效：
composer config -g repo.packagist应输出完整 JSON；再跑composer show -p -vvv 2>&1 | grep aliyun.com，确认请求 URL 确实含aliyun.com
项目级 repositories 配置会彻底覆盖全局设置
即使全局已切成功，只要项目根目录的 composer.json 中存在 repositories 字段（比如遗留的腾讯云、phpcomposer.com 或私有源），Composer 就会优先使用它，全局镜像形同虚设。
检查方式：grep -A5 '"repositories"' composer.json
安全清理方式（在项目目录下运行）：composer config --unset repositories（比手动删 JSON 更可靠，避免格式错误）
-r 参数只对部分命令有效，且不反映真实环境
-r 是调试和 CI 场景的临时开关，但它有明确限制：
- 支持：
composer install、composer update、composer show - 不支持：
composer create-project（必须用--repository-url=） - 关键陷阱：
-r会**完全忽略所有已配置源**（包括项目级和全局），测得快，但不代表你日常开发的真实链路
CI 流水线中若只靠 -r 跑一次 install 就认为“镜像已就绪”，后续 require 或 update 仍可能直连 packagist.org —— 这是最容易被忽略的断点。
