报invalid repository时，90%是composer.json中repositories配置不合法：type与url不匹配（如vcs缺.git、composer少末尾/）、JSON格式错误或字段缺失，需用composer diagnose定位并curl/git命令验证真实可达性。
报invalid repository时，先看composer.json里repositories字段是否合法
90% 的 invalid repository 错误不是网络不通，而是 repositories 数组中某条配置本身不满足 Composer 的硬性校验规则。Composer 在解析阶段就直接拒绝，根本不会发 HTTP 请求。
必须逐条检查每项的 type 和 url 是否匹配：
-
type: "vcs"只接受 Git/SVN/Hg 协议地址，例如"https://gitlab.example.com/group/pkg.git"；写成网页地址"https://gitlab.example.com/group/pkg"（缺.git）会静默失败 -
type: "composer"要求url可访问、返回合法 JSON，且末尾必须带/，比如"https://mirrors.aliyun.com/composer/"✅；少斜杠变成"https://mirrors.aliyun.com/composer"❌，请求路径会拼成/composerpackages.json导致 404 -
type: "package"不需要url字段，但必须提供完整package对象，含name、version、dist或source
运行 composer diagnose，它会明确指出哪一条 repository “failed to parse”，比手动盲猜快得多。
用底层命令验证仓库 URL 是否真能返回预期响应
别信 Composer 报错里的模糊提示，直接绕过它测试真实可达性：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 对
type: "composer"仓库：执行curl -I https://your-repo.com/packages.json，确认返回HTTP/2 200，且响应体是合法 JSON，顶层必须有"packages"键 - 对
type: "vcs"仓库：执行git ls-remote -h https://your-git.com/user/repo.git，能列出 ref 才算通；若报fatal: unable to access，问题在证书、代理或 DNS，和 Composer 配置无关 - Docker 场景下注意：
localhost指的是容器自身——想连宿主机服务，URL 得写成http://host.docker.internal:8080（Linux 启动时需加--add-host=host.docker.internal:host-gateway）
确认 Composer 版本与仓库协议是否兼容
老服务（如旧版 Satis）和新 Composer（≥ 2.2）之间常有字段结构断裂，不是 URL 写错了，而是返回的 JSON 格式不被识别：
-
Composer ≥ 2.2已废弃repo.packagist键名，必须用repositories.packagist.org.type+repositories.packagist.org.url - 某些私有仓库返回的
packages.json缺少packages顶层键、或用了已弃用的providers字段，新版 Composer 直接跳过该源 - 公司内网 Nexus/Artifactory 若 upstream 指向已下线的老镜像（如
https://phpcomposer.com），也会触发 invalid repository，需更新为https://mirrors.aliyun.com/composer/
全局配置被项目级 repositories 完全覆盖时容易误判
只要项目根目录 composer.json 里存在 "repositories" 字段（哪怕只是空数组 []），全局配置就彻底失效——不是优先级低，是根本不读。
这会导致你反复运行 composer config -g repo.packagist ... 却毫无效果：
- 验证方式：
composer config repositories输出的是当前生效的仓库列表，不是config -g --list - 宝塔/CI/Docker 环境中，
~/.composer/config.json可能根本没权限读取，或压根不存在 - 更可靠的做法：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会自动写入composer.json的repositories字段，key 固定为"packagist"
最常被忽略的一点：repositories 是个数组，但 Composer 要求每个元素都必须是对象，不能是 null 或字符串；JSON 格式错误（如多逗号、单引号）会导致整块被跳过，且不报错。
