auth.json是唯一可靠选择,因Composer仅在拉取私有源元数据时按project-root/auth.json→COMPOSER_HOME/auth.json顺序查找凭证,不读取环境变量或命令行参数;CI容器无用户主目录上下文,全局配置不可靠,项目级auth.json路径明确、作用域清晰、权限可控。

必须用 auth.json 文件配凭证,其他方式在 CI 或多项目环境下大概率失效。
为什么 auth.json 是唯一可靠选择
Composer 不会从环境变量、全局 config 或命令行参数中读取私有源认证信息来完成包元数据拉取(比如 composer update 初次解析依赖树时)。它只在请求私有 Composer 源(type: "composer")或私有 VCS 仓库(type: "vcs")的 packages.json 或 Git 数据时,才按顺序查找:project-root/auth.json → COMPOSER_HOME/auth.json。CI 容器里没有用户主目录上下文,全局配置基本不可靠。
-
auth.json必须和composer.json同级,且权限设为600(chmod 600 auth.json) - 内容必须是合法 JSON,不能有多余逗号或注释
- 域名必须与实际请求地址完全一致(比如请求
https://packagist.example.com,就写"packagist.example.com",不能写"www.packagist.example.com"或带端口)
auth.json 的三种常见写法对应不同源类型
Private Packagist、Satis、GitLab 私有源等都属于 Composer 类型源;GitHub/GitLab 私有仓库则走 VCS 类型。它们的凭证格式不互通。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- Private Packagist / 自建 Composer 源(
type: "composer"):
用http-basic,用户名填 API token,密码留空字符串:{ "http-basic": { "packagist.example.com": { "username": "pk_abc123def456", "password": "" } } } - GitHub 私有仓库(
type: "vcs", HTTPS URL):
用github-oauth字段:{ "github-oauth": { "github.com": "ghp_xxx..." } } - GitLab 私有仓库(
type: "vcs", HTTPS URL):
用gitlab-token字段:{ "gitlab-token": { "gitlab.example.com": "glpat-xxx..." } }
容易踩的坑:凭证写了但还是 401
这不是 token 错了,而是路径、顺序或协议不匹配导致 Composer 根本没用上你写的凭证。
-
repositories数组没写在项目根目录的composer.json里,而是误写在私有包自己的composer.json中 —— Composer 完全忽略 - 私有源 URL 写成
https://packagist.example.com/packages.json,但auth.json里配的是"packagist.example.com"—— 实际请求域名是packagist.example.com,没问题;但如果 URL 是https://api.packagist.example.com,那auth.json就得配"api.packagist.example.com" - 用了 SSH URL(如
git@gitlab.example.com:group/repo.git),却还在auth.json里配gitlab-token—— SSH 认证走的是系统 ssh-agent,跟auth.json无关 - CI 环境里用
composer config --global写凭证,但容器里COMPOSER_HOME没指定或被覆盖,导致找不到全局auth.json
最稳的做法:把 auth.json 放进项目根目录,gitignore 掉,CI 流水线用 secret 注入该文件内容再执行 composer install —— 这样既明确,又绕过所有路径和作用域歧义。










