解决Composer中文镜像导致的包描述文件元数据丢失-composer-PHP中文网

答案是元数据未同步或缓存残留，而非镜像故障；需用composer config -g repos.packagist.url确认实际镜像地址，curl -i测试packages.json和p/package.json返回200及最新last-modified，再手动删除对应https---mirrors.aliyun.com-composer元数据缓存目录，而非仅执行clear-cache。

解决composer中文镜像导致的包描述文件元数据丢失

元数据丢失不是镜像“坏了”，而是 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 Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 多一个短横、少一个斜杠，或在子模块里没单独配镜像，都会让元数据卡在旧快照上不动。