Composer报invalid repository错误，根本原因是repositories中某条仓库配置格式不合法或协议/认证不被支持：需检查type与url匹配性（如vcs必须为Git地址、composer必须返回packages.json）、私有仓库认证是否配置正确（HTTPS含token或SSH密钥可用）、Composer版本与仓库协议兼容性（如Satis需v2.0+），并逐条注释排查。
Composer 报 invalid repository 错误，基本可以确定是 repositories 配置里某条仓库定义格式不合法，或协议/认证方式不被当前 Composer 版本支持。
检查 repositories 数组中每条仓库的 type 和 url 是否匹配
Composer 对不同 type 的仓库有严格校验逻辑。比如：
-
type: "vcs"要求url是 Git/Svn/Hg 等版本控制地址（如https://gitlab.example.com/myorg/mypkg.git），不能是纯 HTTP API 地址 -
type: "composer"要求url指向一个合法的 Composer 仓库服务（如https://packagist.example.com），且该地址必须能返回packages.json或响应GET /packages/list.json -
type: "package"不需要url，但必须提供完整package结构体，且name、version、dist或source缺一不可
私有 Git 仓库未配置正确认证时也会触发此错误
当 type: "vcs" 指向私有 Git 地址（如 https://gitlab.example.com/private/pkg.git），而本地未配置对应凭据，Composer 在尝试探测仓库元信息时可能返回空响应或 401，进而误判为“无效仓库”。
One-click installation of GitHub projects
下载
GInstall OneClick — 一键安装 GitHub 项目：规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。
- 确认
git config --global credential.helper已启用，或已运行git clone成功过该地址 - 若用 HTTPS + Token，确保 URL 中包含 token：如
https://oauth2:TOKEN@gitlab.example.com/private/pkg.git - 若用 SSH，确保
url是git@gitlab.example.com:private/pkg.git格式，且ssh -T git@gitlab.example.com可通 - Composer 2.2+ 支持
auth字段，可在repositories内直接写："auth": {"token": "xxx"}，但仅对部分托管平台有效（GitLab/GitHub 的 API 模式）
Composer 版本与仓库协议不兼容（尤其自建 Satis/SatisPress）
老版本 Satis 生成的 packages.json 缺少 mirrors 或 notify-batch 字段，或使用了 Composer 1.x 已弃用的字段（如 providers 数组嵌套过深），会导致 Composer 2.x 直接拒绝加载整个仓库。
- 运行
composer diagnose，它会明确提示哪条repository“failed to parse” - 手动访问
url+/packages.json，检查 JSON 是否合法、顶层是否含packages键、是否有明显语法错误 - Satis 用户请升级到 v2.0+ 并用
satis build重新生成；SatisPress 用户需确认插件启用且重写了packages.json的输出结构 - 临时绕过校验可加
--no-plugins，但只是掩耳盗铃，不能解决根本问题
最常被忽略的是：错误提示里的 invalid repository 并不指明是第几个仓库出错，而 Composer 解析 repositories 是顺序执行的——只要前面某条非法，后面的就全被跳过。务必逐条注释排查，别只盯着最后加的那条。
