composer报“repository is not available”主因是配置的镜像源失效或不可用，如返回非200状态码、非application/json响应、重定向或api接口不完整，需用curl和composer diag验证镜像可用性并改用阿里云等稳定镜像。
为什么 Composer 会报 “Repository is not available”
这通常不是你本地环境的问题，而是 Composer 尝试访问的远程仓库（比如 packagist.org）在当前网络下无法连通，或你配置的镜像源已失效、返回了非标准响应。Composer 的 repositories 配置一旦指向一个不可用或格式不兼容的镜像（例如返回 HTML 页面而非 JSON），就会直接中断并抛出这个错误。
- 常见诱因：国内用户未正确配置国内镜像，或误用了已下线的镜像地址（如老版本的 phpcomposer.com）
- 注意：
composer config -g repo.packagist设置的全局镜像，如果返回 404 或重定向到登录页，也会触发该提示 - 不是所有“能打开网页”的镜像都可用——Composer 要求镜像必须完整实现 Packagist 的 API 接口（尤其是
/packages/list/和/p/[vendor]/[package]/）
验证镜像是否真正可用的三步检查法
别急着换源，先确认是不是镜像本身出了问题：
- 用
curl -I https://packagist.phpcomposer.com/packages.json（示例旧镜像）看返回状态码——必须是200，且Content-Type是application/json - 访问
https://mirrors.aliyun.com/composer/p/provider-2024-07.json（阿里云镜像的真实路径）——能直接下载 JSON 文件才算有效 - 运行
composer diag，重点观察 “Checking platform settings” 后是否出现 “The configured repository is not available” 及具体 URL
推荐且当前稳定的镜像配置方式
2024 年起，Packagist 官方推荐使用 packagist.org 自带的镜像调度（需科学上网），而国内稳定可用的只有两个主流选项：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 阿里云镜像（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云镜像（备用）：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 不要用
https://packagist.phpcomposer.com——该域名已停用，返回 302 跳转，触发 “Repository is not available” - 如果项目级配置，改
composer.json中的repositories，确保type是composer，url末尾有斜杠（/），否则某些镜像会 404
遇到 “Repository is not available” 还没解决？优先排查这些点
很多问题其实和镜像无关，而是配置残留或权限干扰：
- 检查是否有
~/.composer/config.json里残留了多个repo.packagist条目——Composer 只认最后一个，但冲突会导致解析失败 - 公司网络可能拦截了
https://mirrors.aliyun.com的子路径（如/composer/p/...），可临时用composer install -vvv看具体卡在哪条 HTTP 请求 - PHP 的
allow_url_fopen关闭或 cURL 缺少 SSL 支持（尤其 Windows XAMPP）也会模拟出“仓库不可用”的现象，用php -r "print_r(get_headers('https://mirrors.aliyun.com/composer/packages.json'));"快速验证
镜像本身只是代理，真正决定成败的是你机器能否拿到结构正确的 JSON 响应——任何中间环节（DNS、HTTPS 证书、HTTP 重定向、防火墙）出问题，都会被 Composer 统一归为 “Repository is not available”。
