Composer下载失败主因是镜像配置错误：键名必须为repo.packagist（非repos.packagist）、第二参数必须为composer、URL须HTTPS且末尾带/，三者缺一即静默回退至packagist.org；需清缓存、删vendor与lock文件，并用composer install -vvv验证日志中是否出现镜像域名。
Composer下载失败、卡在Downloading、反复超时，90%不是网络本身问题，而是配置没对齐镜像源的硬性要求——键名错、type漏、URL少斜杠，三者任一出错就静默回退到https://packagist.org，你还在等它连通。
确认当前源是否真生效，别信“命令没报错”
运行composer config -g repo.packagist，输出必须是完整 URL（如https://mirrors.aliyun.com/composer/）或标准 JSON（如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}）。如果为空、null、或仍是https://packagist.org，说明配置根本没写进去。
常见失效原因：
-
repo.packagist写成repos.packagist（多一个s），Composer 2.x+ 直接忽略，不提示也不警告 - 漏掉中间的
composer类型参数：composer config -g repo.packagist https://mirrors.aliyun.com/composer/❌，必须是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅ - URL末尾没加
/：https://mirrors.aliyun.com/composer❌ → 请求路径拼成/composerpackages.json导致 404；正确是https://mirrors.aliyun.com/composer/✅
换源后仍失败？缓存和锁文件必须清
镜像只影响新拉取行为，但composer.lock里存着旧 dist URL，vendor/里缓着原始地址的包，~/.composer/cache/里还存着 packagist.org 的元数据——不清理，换源等于白配。
必须执行以下三步：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer clear-cache：强制丢弃所有本地缓存，避免校验阶段仍连境外源 - 删掉
composer.lock和vendor/目录：确保后续composer install从头走镜像流程 - 再跑
composer install -vvv 2>&1 | grep "Downloading"：确认日志中出现mirrors.aliyun.com或对应镜像域名，而非codeload.github.com或packagist.org
并发数调高前，先确保镜像和 PHP 环境就绪
Composer 2.1+ 默认已启用并行下载，但并发数默认仅 3–6，且极易被拖垮。调高http-max-concurrent-downloads才真正有效：
- 全局设为 8（多数机器稳妥上限）：
composer config -g http-max-concurrent-downloads 8 - 别设超过 10：阿里云/腾讯云镜像在并发 >12 时易返回
429 Too Many Requests；GitHub 源可能触发403 rate limit exceeded - 必须配合国内镜像 +
clear-cache，否则并发再高也卡在 DNS 或 TLS 握手 - 检查 PHP 是否启用了
curl扩展：php -m | grep curl，没启用会退化为串行，且不报错
项目级配置比全局更可靠，尤其在 CI/宝塔/Docker 中
全局配置写入~/.composer/config.json，但它只对当前用户生效。宝塔用www用户、GitHub Actions 用runner、Docker 容器常用www-data——它们读不到你本地root或个人用户的配置。
更稳的做法是进项目根目录后执行：
-
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/：写入项目composer.json的repositories字段，Git 提交后所有人自动生效 - 改完立刻跑
composer update --lock：否则composer.lock里仍存旧的dist.url，下载时先试境外地址，失败才 fallback - 私有仓库若存在，确保
composer.json中repositories结构完整，删composer.lock后不会漏包
最容易被跳过的点：换源后不验证日志，只看命令是否“跑完”。真正的判断依据只有composer install -vvv输出里的Downloading行是否命中镜像域名——其他全是幻觉。
