答案是composer diag默认只连官方源，不验证镜像；真正验证需用composer config -g repos.packagist.org.url获取实际镜像地址，再curl -I测packages.json返回200，并手动清理provider缓存目录而非仅clear-cache。
Composer 在中文镜像下报错，90% 不是镜像坏了，而是你没验证它是否真在用、真能通、真同步。 诊断必须绕过 composer diag 的误导性输出，直击实际请求链路。
为什么 composer diag 显示失败，但阿里云镜像其实好着？
composer diag 默认只连 https://packagist.org，完全不读你配的镜像地址。它只检查 PHP 环境基础能力（OpenSSL、curl、系统时间），不是镜像可用性测试工具。
- 看到
Connection to https://packagist.org failed≠ 镜像挂了，只是说明你本地 HTTPS 基础环境可能有问题（比如系统时间偏差 >5 分钟、CA 证书路径不对） - 真正验证镜像是否生效：运行
composer config -g repo.packagist，输出必须是{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}（注意末尾有/） - 再手动测元数据接口：
curl -I https://mirrors.aliyun.com/composer/packages.json，必须秒回HTTP/2 200才算通
composer show vendor/package 找不到包，清缓存没用怎么办？
composer clear-cache 只删 ZIP 包和 dist 缓存，对 provider 元数据（packages.json、p/vendor/package.json）几乎无效。镜像同步延迟导致的“找不到”，本质是 Composer 还在读旧索引。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先定位缓存目录：
ls -d ~/.composer/cache/repo/https---mirrors.aliyun.com-composer（Linux/macOS）或%APPDATA%\Composer\cache\repo\https---mirrors.aliyun.com-composer（Windows） - 直接删掉整个目录：
rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer - 再跑
composer show vendor/package，Composer 会强制重拉最新packages.json和对应p/vendor/package.json
项目里 composer install 还是连 packagist.org？
项目级 composer.json 中的 repositories 字段会静默屏蔽全局镜像配置，优先级更高。哪怕你全局配了阿里云，只要项目里写了 "repositories": [] 或 "repositories": {}，就会退回到默认源。
- 进项目根目录，运行
composer config repo.packagist—— 如果有输出，说明项目级已覆盖全局 - 检查
composer.json是否含"repositories"字段；空数组、空对象、甚至"packagist.org": false都会导致镜像失效 - CI/CD 流水线（如 GitHub Actions）默认不继承本地全局配置，必须在 workflow 文件里显式执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
报 file could not be downloaded 却已切镜像？查这三件事
这个错误在国内基本和网络无关，而是 CA 证书、镜像时效、HTTPS 校验三者之一出问题。
-
curl.cainfo路径是否真实存在且可读？运行php --ini找到加载的php.ini，确认里面有curl.cainfo = "/etc/ssl/certs/ca-certificates.crt"（Linux）或对应 Windows 路径 - 镜像 URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（会拼成.../composer/packages.json导致 404） - 企业内网若走中间人代理，
curl -I卡在 TLS handshake 时，加CURL_IPRESOLVE=4强制 IPv4 再试；或临时关校验：composer config -g secure-http false（仅限开发机）
最常被忽略的是：镜像配置写对了 ≠ 请求发出去了。一定要用 composer install -vvv | grep "Downloading" 看实际域名，否则所有排查都是盲猜。
