Composer全局配置失效主因是COMPOSER_HOME路径错配、项目级repositories字段屏蔽或镜像URL缺末尾斜杠；需验证home路径、清缓存删lock/vendor、确保URL为HTTPS且以/结尾。
确认当前 Composer 运行用户和 COMPOSER_HOME 路径
在 Docker 容器里，Composer 全局配置常被写错位置——比如你用 root 执行了 composer config -g repo.packagist，但 PHP 进程实际以 www-data 或 app 用户运行，它读的是自己家目录下的 ~/.composer/config.json，而不是 root 写的那个。
必须验证两件事是否一致：
-
composer config --global home输出的路径 - 当前运行 Composer 的用户（如
www-data）的$HOME/.composer是否真实存在且可读写
检查方式：
echo $COMPOSER_HOME ls -la /home/www/.composer/config.json # 替换为实际用户 HOME
若不一致，说明 COMPOSER_HOME 被显式设错或继承自构建阶段；Dockerfile 中应避免 sudo 或 USER root 后再配全局源，改用目标用户执行配置。
检查项目级 composer.json 是否静默屏蔽全局镜像
即使 composer config -g repo.packagist 显示正常，composer install 日志里仍出现 packagist.org 或 codeload.github.com 请求——大概率是项目级 composer.json 里写了 "repositories" 字段。
Composer 的源优先级是：项目级 > 全局 > 默认源，没有协商，没有 fallback。只要存在该字段（哪怕值是 []、{} 或 {"packagist.org": false}），全局镜像就彻底失效。
快速验证：
composer config repositories
若输出含 https://repo.packagist.org 或非镜像 URL，就是它在作祟。定位方式：
grep -A5 '"repositories"' composer.json
临时禁用（仅对当前项目）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config --unset repositories
用 why-not 和 prohibits 定位冲突源头，而非瞎猜
Docker 环境下报 “Conclusion: don’t install xxx” 或 “found x packages that conflict”，本质是依赖图中版本约束无交集。别删 composer.lock，先让 Composer 告诉你谁在拦路。
两个命令分工明确：
-
composer why-not vendor/package:version：从你手动 require 的包出发，逆推谁锁死了目标版本（最上面一行通常是Root package requires） -
composer prohibits psr/log:3.0.0：直接查谁明确拒绝这个版本，适合已知冲突点但不确定谁提的要求
例如：composer prohibits monolog/monolog:3.0.0 输出：
myapp dev-main requires monolog/monolog (^2.0) laravel/framework v10.48.0 requires monolog/monolog (^2.9)
说明不是网络问题，是你 composer.json 里写了太窄的约束，或 Laravel 版本还没支持 Monolog v3。
验证镜像 URL 是否带 trailing slash 且为 HTTPS
Docker 构建时如果用了错误的镜像地址，比如 https://mirrors.aliyun.com/composer（缺末尾 /），Composer 会拼出 /composerpackages.json 这种非法路径，返回 404 后安静切回官方源——不报错、不提示，composer install -vvv 日志里只显示 “Could not fetch”。
真实生效的 URL 必须满足：
- 协议为
HTTPS - 末尾有
/
✅ 正确：https://mirrors.aliyun.com/composer/
❌ 错误：https://mirrors.aliyun.com/composer（少 /）
❌ 错误：http://mirrors.aliyun.com/composer/（非 HTTPS）
验证方式（在容器内执行）：
curl -I https://mirrors.aliyun.com/composer/
应返回 200 OK 或至少 301 Moved Permanently；若返回 404，立刻检查 URL 拼写和 trailing slash。
