为什么Composer install报错提示无可用镜像？源健康状况自主排查-composer-PHP中文网

composer报“no valid package sources”是因packagist源配置为空、无效或被项目级repositories屏蔽；需先unset项目级配置，再用四要素完整设置全局镜像，验证url响应头为200且路径正确，最后清理provider缓存强制更新元数据。

为什么composer install报错提示无可用镜像？源健康状况自主排查

composer install 报“no valid package sources”或“could not find package”

这不是镜像挂了，而是 Composer 根本没找到可用的 Packagist 源——大概率是 repo.packagist 配置为空、无效，或被项目级 repositories 字段彻底屏蔽。

常见现象：

运行 composer config -g repo.packagist 输出为空、null 或仍是 https://packagist.org/
composer install -vvv 日志里第一行就出现 Downloading https://api.packagist.org/packages.json
项目根目录 composer.json 里有 "repositories": [] 或 "repositories": {}（Laravel 脚手架常带这个）

实操建议：

先清项目级覆盖：composer config --unset repositories（注意无 -g）
重设全局镜像，必须四要素齐全：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否写入成功：composer config -g repo.packagist 输出应为完整 JSON，含 "type": "composer" 和带斜杠的 HTTPS URL

curl -I https://mirrors.aliyun.com/composer/packages.json 返回 404 或 HTML 页面

说明镜像地址本身不可用，或你访问的是已下线/路径变更的旧源。当前（2026 年）稳定可用的地址只有几个，错一个就 404。

关键检查点：

阿里云：必须是 https://mirrors.aliyun.com/composer/（结尾斜杠不能少）
华为云：已迁至 https://repo.huaweicloud.com/repository/php/（不是 mirrors.huaweicloud.com/composer/）
腾讯云镜像自 2023 年起已停更，https://mirrors.cloud.tencent.com/composer/ 不再同步，别再试

验证命令（必须用 -I 看响应头）：

curl -I https://mirrors.aliyun.com/composer/packages.json

正确响应必须是 HTTP/2 200 或 HTTP/1.1 200 OK；若返回 HTTP/2 404 或 HTML 内容（比如人机验证页），说明该镜像不适用于自动化场景，立刻换源。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

composer diagnose 显示 OK，但 install 仍失败

composer diagnose 不发网络请求，只做本地配置校验，“OK” 完全不代表镜像能连通。它甚至不会检查 repo.packagist 的 URL 是否真实可访问。

真正有效的验证方式只有两个：

看 composer install -vvv 日志里第一条 Downloading 行的 URL，那是 Composer 实际发起请求的地址
用 curl -I 直接打那个 URL，确认状态码和响应头

特别注意：如果日志里出现 codeload.github.com 或 api.github.com，说明 Composer 已 fallback 到 GitHub 源——这通常是因为镜像元数据缓存损坏，或 packages.json 同步延迟导致索引缺失，不是网络问题。

删了 vendor 和 lock，clear-cache 也执行了，还是查不到包

Composer 的元数据缓存（packages.json、provider-*.json）和 ZIP 包缓存是分开的。composer clear-cache 只清后者，对前者基本无效。

必须手动清理 provider 缓存目录：

查路径：ls -d ~/.composer/cache/repo/https---mirrors.aliyun.com-composer
删掉它：rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer
Windows 用户路径类似：%APPDATA%\Composer\cache\repo\https---mirrors.aliyun.com-composer

删完立刻运行 composer show monolog/monolog，Composer 会强制重新拉取最新元数据。别跳过这步——国内镜像同步有 5–30 分钟延迟，缓存不干净，你就永远卡在旧时间点。