Composer私有仓库报错90%是配置非法而非网络权限——运行composer diagnose可定位非法repositories行；type拼错、URL缺.git或/、auth.json路径/权限/域名不匹配等均导致静默失败。
私有仓库报错，90% 不是网络或权限问题，而是配置本身不合法——Composer 在解析 repositories 时会严格校验 type、url、结构，错一个字段就静默跳过，甚至直接中断整个流程。
报 invalid repository 或 Repository not found 怎么快速定位
这不是连不上服务器，是 Composer 根本没发请求，因为某条 repositories 配置被判定为非法。最省时间的做法是运行 composer diagnose，它会明确告诉你哪一行 “failed to parse”。常见硬性规则包括：
-
type: "vcs"必须配 Git/SVN 地址，且 URL 末尾带.git（如https://gitlab.example.com/myorg/pkg.git），写成网页地址直接失效 -
type: "composer"的 URL 必须可访问、返回 HTTP 200、响应体是合法 JSON 且含顶层packages键，路径末尾必须有/（如https://satis.example.com/） -
type: "package"在 Composer ≥ 2.2 已被移除，改用type: "artifact"或迁移到composer类型源 - 多个
repositories条目中只要有一个type拼错（比如"compsoer"），整个解析就会失败，不会继续往后看
加了私有源却 still Could not find package
根本原因不是 URL 写错了，而是 Composer 默认关闭了 packagist.org 的隐式源——哪怕你只加了一条 vcs，它也不会再去查 Packagist，除非你显式兜底。解决方式只有两种：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在项目级
composer.json的repositories数组里，补上这一条：{"type": "composer", "url": "https://packagist.org", "packagist": false}（注意不是删掉，是显式禁用） - 或者更稳妥地：把私有源放数组最前面，再加这条兜底项，确保路由可控
- 别依赖
composer config -g repositories；全局配置和项目级composer.json冲突时，后者完全屏蔽前者
Could not authenticate 或 401 Unauthorized
这不是密码错了，是凭证压根没加载。Composer 在没拿到有效认证时，会静默 fallback 到未授权请求，最终返回 401。验证步骤很直接：
- 运行
composer config --global --list | grep http-basic，如果无输出，说明凭据没写进去 -
auth.json必须放在~/.composer/auth.json（Linux/macOS）或%APPDATA%\Composer\auth.json（Windows），权限必须是600，编码必须是 UTF-8（不能带 BOM） - 域名必须完全一致：如果仓库 URL 是
https://gitlab.internal:8080/myorg/pkg.git，那么auth.json里的 key 就得是"gitlab.internal:8080"，端口不能省 - CI 环境必须用
COMPOSER_AUTH环境变量注入，格式为 JSON 字符串，优先级最高，硬编码进脚本或composer.json是危险操作
镜像源配了但 composer install 还走外网
典型表现是 composer config -g repo.packagist 输出为空或 null，但 Composer 不报错也不提示。三个关键点必须同时满足：
- 键名必须是
repo.packagist（不是repos.packagist或repository.packagist） -
type值必须显式写composer（不能省略） - URL 必须以
/结尾（如https://mirrors.aliyun.com/composer/），少一个斜杠会导致拼出非法路径/composerpackages.json，404 后静默回退 - 验证是否生效：运行
composer config -g repo.packagist，输出应为完整 JSON，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
真正容易被忽略的是：Composer 对配置的合法性校验发生在解析阶段，而非运行阶段；它不会告诉你“第5行 type 写错了”，只会整体失败。所以排查永远从 composer diagnose 和底层命令（curl -I、git ls-remote）开始，而不是先改权限或换网络。
