根本原因是默认超时阈值太低且并行下载无重试机制，应先全局设置composer config -g process-timeout 600并禁用并发（composer config -g use-include-path false），再切换阿里云镜像源，同时排查prefer-source和ci中composer_home未固化问题。
Composer安装卡在Downloading或报Connection timed out，不是网络不通，是默认超时阈值太低（process-timeout=300秒但实际常被并发和TLS握手拖垮），加上默认并行下载+无重试机制，一碰到国内镜像响应波动就直接失败。
怎么调高超时并禁用并发下载
临时提全局超时最直接：运行composer config -g process-timeout 600（单位秒，600=10分钟）。若仍失败，可设为0（无限等待，仅调试用）。
禁用并行下载能显著降低连接压力：
composer config -g use-include-path false- 配合环境变量
COMPOSER_PROCESS_TIMEOUT=0（部分Composer版本更认这个而非config） - CI/CD中必须显式设置
COMPOSER_HOME，否则容器重启后配置丢失
换镜像源但为什么还是慢
换源不等于提速成功——阿里云、腾讯云镜像只加速dist包（ZIP/TAR），对source（Git clone）无效。项目里若存在"prefer-source": true或私有仓库（如git@github.com:xxx），镜像完全不代理，Composer会 fallback 到直连，触发超时。
实操要点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先清旧缓存：
composer clear-cache - 确认生效：
composer config -g repo.packagist输出应含"url": "https://mirrors.aliyun.com/composer/" - 检查项目
composer.json是否硬编码了repositories字段，优先级高于全局配置；已下线的私有源会导致逐个超时重试 - 临时验证是否镜像生效：
composer install --no-plugins --repository=https://packagist.org
autoload阶段卡住不是网络问题
如果composer install卡在Generating autoload files后无响应，大概率不是连接超时，而是PHP递归扫描vendor目录时被I/O阻塞——常见于WSL2、Docker for Mac或NTFS挂载卷。
快速定位与绕过：
- 跳过autoload生成（仅调试）：
composer install --no-autoloader，之后手动跑composer dump-autoload --optimize - 检查APCu是否启用但未配
apc.enable_cli=1（CLI模式下autoload构建会异常缓慢） - WSL2用户确认
/mnt/c/路径已加入/etc/wsl.conf的automount白名单，否则大量symlink扫描会卡死
CI/CD中容易被忽略的配置点
CI环境里最容易踩的坑是“以为配置写进去了，其实没生效”。比如composer config -g写入的是容器内home目录，但流水线每次启动新容器，COMPOSER_HOME未固定就等于配置丢了。
必须固化以下几项：
-
COMPOSER_PROCESS_TIMEOUT=0（或至少600） -
COMPOSER_HOME=/tmp/composer（确保路径可写且跨构建持久） - 命令必须带
--no-interaction --no-progress --optimize-autoloader，禁用交互和进度条可减少I/O开销 - 别混用
install和update：同一项目只允许update在开发机执行，install在服务器执行
真正卡住的地方，往往不在网络本身，而在autoload生成时的I/O阻塞、CI中未固化的环境变量、或者镜像源和prefer-source配置的隐性冲突——这些点不手动验证，光调timeout没用。
