auth.json中host必须与私有源URL的host部分完全一致(协议、端口、大小写均敏感),否则认证静默失效;验证需用composer -vvv require... | grep "Authentication"确认是否触发。

auth.json 里 host 不匹配是最常见原因
Composer 加载 auth.json 时,只认 URL 的 host 部分(不含协议、端口、路径),且严格区分大小写。比如私有源是 https://pkg.myorg.com/,那 auth.json 里必须写 "pkg.myorg.com";写成 "https://pkg.myorg.com"、"myorg.com" 或 "PKG.MYORG.COM" 都会跳过认证。
验证方式:运行 composer -vvv require myorg/internal-sdk 2>&1 | grep "Authentication",如果没输出或显示 no authentication,基本就是 host 不对。
-
auth.json默认位置有两个:项目根目录下的auth.json(仅当前项目生效),或全局的~/.composer/auth.json - Linux/macOS 下权限必须是
600,否则 Composer 静默忽略该文件 - 不要把凭证写进
composer.json的config字段——它不支持认证配置
GitHub 私有仓库要用 PAT,不是密码
GitHub 已彻底禁用密码认证,Composer 拉取 https://github.com/username/private-repo.git 时,若没配 PAT,一定会报 Could not authenticate 或 401 Unauthorized,和网络无关。
正确做法是生成带 repo 权限的 Personal Access Token,然后执行:
composer config --global github-oauth.github.com <your-token-here>
注意:github.com 是固定 host,不能写成 www.github.com 或 api.github.com。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- Token 必须勾选
repo范围,public_repo不够用 - SSH 方式(
git@github.com:...)可绕过此问题,但需本地ssh-agent已加载密钥且ssh -T git@github.com能通 - 改完后必须
composer clear-cache,否则旧缓存可能继续复用失败凭证
composer diagnose 会直接告诉你哪行配置非法
很多“认证失败”其实是配置本身不合法,导致 Composer 根本没走到认证那步——比如 repositories 里某条 type 拼错成 "compsoer",整块配置被静默丢弃,后续所有请求都 fallback 到 packagist.org,自然 401 或 404。
运行 composer diagnose,它会明确指出类似这样的错误:
Invalid repository at index 0: Failed to parse JSON in .../composer.json
这时候去看 composer.json 的 repositories 数组第 0 项,大概率是 url 缺 .git、少末尾 /、或 type 值非法。
-
type: "vcs"的 URL 必须是 Git 可 clone 地址,结尾必须是.git -
type: "composer"的 URL 必须返回 HTTP 200,响应体是合法 JSON 且含packages键,结尾必须是/ - 多个
repositories条目中只要一个出错,整个数组解析失败,不会继续往后读
私有源没生效,根本就不会触发认证
很多人以为配了 auth.json 就万事大吉,但实际日志里压根没出现私有域名的请求——说明 Composer 根本没走你配的源。最典型原因是没关掉 packagist.org。
检查 composer config repositories 输出,如果看到 https://repo.packagist.org 还在,或者没出现 {"packagist.org": false} 这个独立对象,那就确认没生效。
-
{"packagist.org": false}必须是repositories数组里的**最后一个元素**,不能嵌套、不能合并、不能写成"packagist": false - 私有源要放在它前面,顺序不能颠倒
-
composer search永远只查 packagist.org,不能用来验证私有源是否启用
composer config repositories 和 composer diagnose 确认源配置合法且启用,再盯日志里有没有对应域名的 GET 请求,最后才查 auth.json 是否命中。

















