答案是元数据未同步或缓存残留，而非镜像故障；需用composer config -g repos.packagist.url确认实际镜像地址，curl -I测试packages.json和p/package.json返回200及最新Last-Modified，再手动删除对应https---mirrors.aliyun.com-composer元数据缓存目录，而非仅执行clear-cache。
元数据丢失不是镜像“坏了”，而是 Composer 没拿到最新 packages.json 或对应 provider-*.json——删错缓存、配错源、或根本没走镜像，才是真因。
composer diag 说不通？它根本没测你的镜像
composer diag 默认只连 https://packagist.org，完全无视你配置的阿里云/腾讯/中科大镜像。它报 “Connection failed” 只说明本地 PHP 环境（OpenSSL、curl、系统时间）可能有问题，不代表镜像不可用。
- 真正验证镜像是否生效：运行
composer config -g repos.packagist.url，确认输出是你预期的镜像地址（如https://mirrors.aliyun.com/composer/） - 手动测试元数据接口：
curl -I https://mirrors.aliyun.com/composer/packages.json，必须返回HTTP/2 200才算通 - 查具体包是否同步：
curl -I https://mirrors.aliyun.com/composer/p/spatie/laravel-ray.json，看状态码和Last-Modified时间戳是否接近当前时间
删了 clear-cache 还是找不到包？你删错了地方
composer clear-cache 只清 ~/.composer/cache/files/ 下的 ZIP 包和 dist 缓存，对决定“有没有这个包”的元数据（packages.json、provider-*.json）完全无效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Linux/macOS 正确清理路径：
rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer - Windows 正确路径：
rd /s /q "%COMPOSER_HOME%\cache\repo\https---mirrors.aliyun.com-composer" - 路径中的
https---mirrors.aliyun.com-composer是 URL 转义结果，必须和composer config -g repos.packagist.url输出严格一致（换镜像就得换路径）
项目里写了 repositories 字段？全局镜像直接失效
只要 composer.json 里有 "repositories" 字段，Composer 就彻底忽略全局镜像配置，只按你写的 URL 拉元数据——哪怕你执行过 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。
- 常见陷阱：
"url": "https://packagist.phpcomposer.com"已停服，所有请求 404 - 私有源漏写
"packagist.org": false，会导致连monolog/monolog这种基础包都查不到 - 验证方式：
composer diagnose看 “Repo packagist.org:” 行输出的 URL 是否为你预期的镜像地址
想绕过镜像延迟验证包是否存在？别等，直接试
不想等镜像同步，又需要确认是不是包本身的问题，可以用临时方案绕过：
- 加
--repository=https://packagist.org参数强制走官方源：composer show spatie/laravel-ray --repository=https://packagist.org - 或直接用
curl查 Packagist 原站：curl -I https://packagist.org/p/spatie/laravel-ray.json - 注意：这仅用于验证，不能替代镜像日常使用；国内网络下访问原站可能超时或被限速
最常被忽略的是路径转义和 repositories 作用域——https---mirrors.aliyun.com-composer 多一个短横、少一个斜杠，或在子模块里没单独配镜像，都会让元数据卡在旧快照上不动。
