私有源拉取失败主因是顺序错误或地址不合法：私有源必须置于repositories数组首位且URL结尾带斜杠，镜像源放后；VCS地址须符合git clone规范（HTTPS需.git后缀、SSH用冒号）；认证信息应配在~/.composer/auth.json且域名严格一致。
私有源拉取失败，90%不是网络或权限问题，而是 Composer 根本没按你预期的顺序去请求——它要么跳过了你的私有源，要么发错了请求地址，要么连包名都没匹配上。
私有源被镜像源拦截导致 404
镜像只代理 packagist.org 的公开包，不转发任何私有请求。如果你把阿里云镜像写在 repositories 数组前面，Composer 就会先拿私有包名去镜像查，而镜像根本没有，直接返回 404 Not Found。
- 必须把私有源放在
repositories数组首位：{"type": "composer", "url": "https://your-private-repo.com/"}（注意结尾带斜杠） - 镜像源放后面，比如：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} -
repo.packagist字段不能配私有源——它只接管packagist.org流量，对自定义repositories完全无效
VCS 私有仓库 URL 格式不合法
Composer 要求 VCS 地址必须是能被 git clone 直接执行的命令，不是网页链接。格式错一个字符，就会卡在 No valid composer.json was found 或 Could not fetch。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- HTTPS 必须带
.git后缀：https://gitlab.example.com/group/project.git（缺了就失败） - SSH 必须用冒号分隔：
git@gitlab.example.com:group/project.git（不是斜杠） - 确保目标仓库根目录下有合法
composer.json，且name字段与require中完全一致（大小写、连字符、下划线都算不同包）
认证信息没生效或配置错位
CI 环境报 401 或 403，本地却正常？大概率是 auth.json 没进环境，或者域名/协议不一致。
-
auth.json必须放在~/.composer/auth.json，不能放项目根目录，也不能靠COMPOSER_AUTH环境变量临时覆盖（GitLab token 不走 bearer header） - 域名必须完全一致：
gitlab.example.com≠https://gitlab.example.com≠GitLab.example.com - GitHub Actions 中应通过 secrets 注入：
COMPOSER_AUTH: '{"http-basic":{"gitlab.example.com":{"username":"${{ secrets.USER }}","password":"${{ secrets.TOKEN }}"}}}'
packages.json 返回不合法或未声明提供该包
私有 Composer 源（如 Satis 或私有 Packagist）返回的 packages.json 必须满足两个硬性条件：HTTP 状态码 200 + Content-Type: application/json，且里面要明确列出你 require 的包名。
- 用
curl -I https://your-private-repo.com/packages.json验证状态码和头信息 - 运行
composer show -p vendor/name -vvv，看日志里是否出现Skipping repository due to missing provider—— 出现说明该源根本没声明提供这个包 - 如果用了
providers字段做懒加载，确保它包含"vendor/name"，而不是只写"vendor/*"（通配符不被所有版本支持）
最容易被忽略的是：私有源 URL 的协议和证书链。比如用了 https://，但 CI 环境里 PHP 的 openssl.cafile 路径不对，就会表现为 401（其实是证书校验失败后 fallback 到未授权请求），而不是清晰的 SSL 错误。
