报“Repository not found”或“invalid repository”时，90%是配置本身不合法：type与url不匹配、URL协议错误或服务端未返回预期JSON；需用composer diagnose定位失败项，并以curl或git ls-remote验证真实可达性。

报“Repository not found”或“invalid repository”时，90% 是配置本身不合法

Composer 不会因为网络不通就报这个错，它是在解析 repositories 字段时直接校验失败——连 HTTP 请求都不会发。常见硬性规则被违反就会触发：

• type: "composer" 必须配以 HTTPS URL 且末尾带 /，例如 https://mirrors.aliyun.com/composer/；写成 https://mirrors.aliyun.com/composer（缺斜杠）会导致内部拼出 /composerpackages.json 这种非法路径，404 后直接判“无效”
• type: "vcs" 只接受 Git/SVN/Hg 协议地址，https://github.com/user/repo.git ✅，https://github.com/user/repo ❌（网页地址不认）
• type: "package" 不需要 url 字段，但必须提供完整 package 对象，含 name、version、dist 或 source
• 运行 composer diagnose，它会明确指出哪条 repositories “failed to parse”，比手动猜快得多

全局镜像配置 repo.packagist 在 Composer 2.2+ 已废弃

如果你用的是 Composer ≥ 2.2（当前主流版本），composer config -g repo.packagist 这条命令已失效——它不会报错，但也不会写入任何有效配置。

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 repositories.packagist.org.type composer 和 composer config -g repositories.packagist.org.url https://mirrors.aliyun.com/composer/
• 验证是否生效：运行 composer config -g repositories.packagist.org.url，输出必须是完整 URL，不能是空或 https://packagist.org
• 项目级配置优先级更高：只要项目 composer.json 里有 "repositories": []（哪怕空数组），全局配置就完全被跳过，不是“不优先”，是彻底不读

私有仓库 URL 看似正确，但实际不可达

别信 Composer 的错误提示，它只说“repository invalid”，不说“你连不上”。得用底层命令验证真实响应：

• 对 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
• Docker 场景下，localhost 指容器自身，想连宿主机服务，URL 得写成 http://host.docker.internal:8080（Linux 需加 --add-host=host.docker.internal:host-gateway 启动）
• 公司内网走代理时，COMPOSER_HTTP_PROXY 必须显式设置；Composer 默认不读系统 .gitconfig 的 proxy 配置

缓存残留导致“版本找不到”，清缓存 ≠ 刷新元数据

composer clear-cache 不会删掉最关键的 provider-*.json 文件——这些文件缓存了镜像的索引结构，过期后 Composer 就“看不见”新发布的版本。

• Composer ≥ 2.5：直接运行 composer update --refresh，它精准清理 provider 相关 JSON，不碰已下载包
• 老版本：手动删缓存目录，路径按镜像 URL 转义，例如 rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer
• 临时验证：加 --no-cache 参数，如 composer show -a vendor/pkg --no-cache，强制走网络请求绕过本地索引（仅诊断用，慢）
• 注意：某些镜像（如部分高校源）返回 HTML 页面（人机验证），curl -I 返回 200 OK 但内容不是 JSON，这种镜像不适合自动化场景

真正卡住的地方往往不是语法写错，而是 Composer 在不同版本间悄悄改了键名规则，或者你以为删了缓存就等于刷新了元数据——其实 provider 缓存还躺在那里，固执地告诉你“这个版本不存在”。