404错误常是认证失败的伪装，因Composer未发送Authorization头导致服务器返回HTML登录页或404，而非401；根源在于auth.json配置域名与请求Host不匹配、格式非法或权限错误，须用composer config命令配置并验证生效。
404 错误本身不是认证问题，但 Composer 在认证失败时可能返回 404（而非 401），尤其当私有仓库返回 HTML 登录页或重定向到不存在的路径时——本质仍是 http-basic 配置没生效或域名不匹配。
为什么 404 实际是认证失败的伪装？
Composer 请求私有源时若未携带 Authorization: Basic 头，服务器常返回登录页（HTML）、跳转到 /login 或直接 404（比如 Nexus 返回 404 而非 401）。错误日志里若出现 Failed to decode response: Syntax error，基本可断定：Composer 收到了 HTML，却试图解析 JSON。
- 典型现象：
Could not fetch https://packages.example.com/packages.json: Failed to decode response: Syntax error - 根本原因：凭据未发出 → 服务器拒收请求 → 返回非 JSON 响应 → Composer 解析失败 → 报错看似 404/500，实为认证缺失
- 不是仓库地址写错，而是
http-basic的域名和请求 Host 不一致（例如配了example.com，但实际请求的是packages.example.com）
用 composer config http-basic 命令写入才真正生效
手动编辑 auth.json 极易出错：JSON 格式非法、字段名拼错、多逗号、单引号、注释……Composer 全部静默忽略，不报错也不加载。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 项目级配置（推荐）：
composer config http-basic.packages.example.com deploy 'p@ss$w!rd'（密码含$、!等必须用单引号包裹） - 全局配置（所有项目）：
composer config --global http-basic.gitlab.internal.org ci-bot "${CI_TOKEN}"（支持环境变量展开） - 执行后立刻验证：
composer config --list | grep http-basic（项目级）或composer config --global --list | grep http-basic（全局） - 别信“已写入”，必须看到输出里有对应行——否则等于没配
域名必须与请求 Host 完全一致，不解析协议、路径、端口
Composer 匹配凭据时只看 HTTP 请求头里的 Host 字段。填错一个字符，认证就失效，且无提示。
- 仓库 URL 是
https://packages.myorg.com/api/v2→ 必须配packages.myorg.com，不是myorg.com，也不是https://packages.myorg.com - 仓库 URL 是
https://gitlab.company.com:8443→ 配gitlab.company.com，端口不参与匹配 - 多个私有源要分别配：
packages.a.com和repo.b.net不能合并，也不能用通配符 - GitLab 私有项目需用 Personal Access Token 填入
password字段，不能用登录密码（GitHub 已禁用）
auth.json 文件权限、位置、格式三者缺一不可
Linux/macOS 下权限不对（如 644），Composer 会静默拒绝读取；Windows 下用记事本保存导致 CRLF 换行，也可能解析失败。
- 文件位置优先级：
./auth.json（项目根目录） >$COMPOSER_HOME/auth.json（通常是~/.composer/auth.json） - 必须是纯 JSON：不能有注释、不能用单引号、不能多逗号、不能嵌套在
repositories或其他字段下 - 正确结构仅允许：
{"http-basic":{"packages.example.com":{"username":"u","password":"p"}}} - 务必运行：
chmod 600 auth.json（Linux/macOS），并加入.gitignore—— 这条比配对本身还容易被跳过
