Composer 客户端无内置重试机制，需通过环境变量（如 COMPOSER_PROCESS_TIMEOUT）、HTTP 选项（composer config -g http-options.timeout）或 shell 脚本封装实现重试；镜像服务端不提供重试功能。
Composer 中文镜像本身不提供重试机制，重试行为完全由 Composer 客户端控制；你真正要配置的是 composer 命令自身的网络重试策略，而非镜像服务端。
为什么 composer install 会卡在某个包下载失败就直接退出
默认情况下，Composer 在遇到 HTTP 请求失败（如超时、503、连接拒绝）时不会自动重试，而是立即报错并中断整个流程。这在使用国内镜像（如阿里云、腾讯云、华为云）时尤为明显——偶发的 CDN 节点抖动或源站同步延迟会导致单次请求失败。
常见错误现象包括：
Failed to download vendor/package: The "https://mirrors.aliyun.com/composer/dists/..." file could not be downloaded (HTTP/1.1 503 Service Temporarily Unavailable)- 命令卡在
Downloading https://mirrors.tuna.tsinghua.edu.cn/composer/...后长时间无响应，最终 timeout
通过 COMPOSER_PROCESS_TIMEOUT 和 http-proxy 环境变量间接提升容错
Composer 没有原生的“重试次数”配置项，但可通过组合以下两个参数缓解问题：
-
COMPOSER_PROCESS_TIMEOUT=600：延长单个进程最大执行时间（单位秒），避免因慢速镜像响应被误判为失败 -
COMPOSER_HTTP_PROXY=http://127.0.0.1:8118（可选）：配合本地代理（如cntlm或mitmproxy）实现底层 TCP 层重试，但需自行部署，复杂度高且不推荐用于 CI
更实用的做法是用 shell 封装一层简单重试逻辑：
#!/bin/bash
for i in {1..3}; do
composer install --no-interaction && exit 0
echo "Attempt $i failed, retrying..."
sleep 2
done
echo "All retries failed."
exit 1
改用 composer config 设置全局 HTTP 行为参数
Composer 支持通过 http-options 控制底层 cURL 行为，其中关键参数有：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
timeout：单次请求超时（秒），默认 300，建议设为600 -
max_redirects：最大跳转次数，默认 20，保持默认即可 -
ignore_errors：设为false（默认），确保错误不被静默吞掉
执行以下命令写入全局配置：
composer config -g http-options.timeout 600
注意：http-options 不支持 retry 或 connect-timeout，cURL 的 CURLOPT_CONNECTTIMEOUT_MS 无法通过此接口设置；若需毫秒级连接超时，必须改用自定义 curl wrapper 或 fork Composer。
CI/CD 中最稳妥的重试方案：用 || + sleep 包裹命令
在 GitHub Actions、GitLab CI 或 Jenkins 中，不要依赖 Composer 自身重试——它没有。直接在脚本层补足：
composer install --no-interaction || (sleep 3 && composer install --no-interaction) || (sleep 5 && composer install --no-interaction)
这种写法简单、可控、无需额外依赖，且能明确捕获每次失败原因。如果镜像服务本身返回了 503，大概率是后端临时不可用，等几秒再试往往就能过。
真正容易被忽略的是：镜像 URL 配置错误（比如把 https://packagist.phpcomposer.com 这种已停用地址写死在 composer.json 的 repositories 里）会导致所有重试都无效——先确认 composer config -g repos.packagist 输出的是当前有效的镜像地址（如 https://mirrors.aliyun.com/composer/）。
