composer报could not authenticate或401是因凭据未注入请求头，需检查auth.json是否存在且路径正确（项目根目录或~/.composer/auth.json）、权限≤600、字段名与平台严格匹配（github用github-oauth.github.com配classic pat，gitlab用gitlab-token域名，私有packagist用http-basic精确主机名），并执行composer clear-cache后用composer config -g --auth重建配置。
Composer 报 Could not authenticate 或 401 Unauthorized，不是包不存在、也不是网络不通，而是它压根没把有效的凭据塞进请求头——要么根本没配，要么配错了位置、类型或域名。
检查 auth.json 是否存在且被正确加载
Composer 只认两个地方的 auth.json：项目根目录（临时生效）和全局路径（~/.composer/auth.json 或 %APPDATA%\Composer\auth.json）。它按顺序查找，找到第一个就停，不会合并。
- 运行
composer config --global --list | grep github-oauth，看是否输出掩码 token（如****abcd）；若为空，说明没配或配错位置 - 用
ls -l ./auth.json ~/.composer/auth.json 2>/dev/null确认文件是否存在、权限是否 ≤600（否则 Composer 静默跳过） - 项目根目录有
auth.json时，它会覆盖全局配置——但 CI/容器中常因挂载残留导致误用旧凭据
确认凭据类型和字段名匹配平台要求
GitHub、GitLab、私有 Packagist 各自认不同的字段名和认证方式，填错等于没填。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- GitHub 私有仓库必须用
github-oauth字段，值为 classic PAT（非 fine-grained），且 scope 至少含read:packages和repo；填进http-basic里完全无效 - GitLab 必须用
gitlab-token字段，key 是完整域名（如"gitlab.example.com"），不能是gitlab.com或带端口/路径 - 私有 Packagist（如 Nexus、Satis）一律走
http-basic，username 是 API key，password 留空字符串；域名必须与repositories.url主机名完全一致（不含https://或尾部斜杠）
验证域名是否精确匹配
Composer 匹配凭据时做的是字符串前缀匹配，不是 DNS 解析或重定向跟随。哪怕只差一个字符，认证就被绕过。
- 如果
repositories里写的是https://gitlab.example.com:8443/api/v4，auth.json中的 key 必须是http-basic.gitlab.example.com:8443，不是gitlab.example.com或https://gitlab.example.com - GitHub 只认
github.com，不认api.github.com或www.github.com；写错就等于没配 - URL 中带用户名（如
https://user@repo.example.com）会强制跳过auth.json查找，直接匿名请求
清除缓存并重建配置（顺序不能错）
旧缓存可能复用失败的认证头，手动改 JSON 容易格式出错，命令式配置更可靠。
- 先执行
composer clear-cache，否则后续所有请求都可能复用错误快照 - 再删所有
auth.json：rm -f ./auth.json ~/.composer/auth.json（Windows 用del %APPDATA%\Composer\auth.json） - 最后用命令重建：
composer config -g --auth github-oauth.github.com your_token_here（注意--auth不可省）
最容易被忽略的是：GitHub 的 github-oauth 和 GitLab 的 gitlab-token 不能共存于同一份 auth.json 的同一层级——它们是互斥字段，混写会导致其中一个被静默丢弃。
