--retry=3仅重试网络类可恢复错误,如cURL error 28、Connection refused、Failed to download;不重试依赖冲突、PHP版本不兼容、权限拒绝或Content-Length mismatch等不可恢复错误。

composer install --retry=3 能解决哪些失败?
这个参数只对网络类可恢复错误生效,比如 cURL error 28(超时)、Connection refused、Failed to download。它不会重试依赖冲突、PHP 版本不兼容、权限拒绝或 Content-Length mismatch 这类已下载但校验失败的场景。
实际行为是:每次失败后等待 1 秒再重试,最多尝试 3 次(含首次),不改变请求头、不换源、不清理缓存。
-
--retry=3必须紧跟在install或update后,写成composer install --retry 3会报错 - 它只作用于 HTTP 下载阶段,不影响
post-install-cmd等脚本执行失败 - 若某次重试成功,后续包仍可能失败——
--retry不是全局开关,而是 per-request 控制
为什么 post-install-cmd 里 try/catch 捕获不到 install 失败?
composer install 本身是一个独立进程,一旦在依赖解析、下载或解压阶段失败,就直接退出并返回非零状态码,根本不会进入 PHP 脚本上下文。你在 scripts 里定义的 post-install-cmd 函数,只有整个 install 流程“成功完成”后才被调用。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 想捕获失败,必须在 shell 层包裹命令,比如用
if ! composer install 2>err.log; then ... -
composer install --no-scripts可强制跳过所有钩子,方便你单独测试下载环节是否稳定 - 如果需要上报错误,推荐在
pre-install-cmd记录时间戳,再用外部 wrapper 读取err.log并提取关键行,例如匹配failed或cURL error
HTTP 超时和 process-timeout 必须同时调高
只设 http.timeout 无法防止 git clone 卡死;只设 process-timeout 也无法避免 HTTPS 请求在 TLS 握手阶段就被掐断。这两个参数控制完全不同的环节:
-
http.timeout:DNS + TLS + 首字节 + 整个 body 传输总时长,建议设为600 -
process-timeout:限制git、unzip、php -r "copy()"等子进程生命周期,建议设为1200 - 二者都得写进项目级
composer.json的config段,格式是"http.timeout": 600,不是字符串,也不能用下划线 - 别忘了同步调高 PHP 的
default_socket_timeout,否则 Composer 会在底层被截断,前面所有设置都白搭
镜像源失效时重试毫无意义
如果你配置了阿里云镜像,但它的 /p2/monolog/monolog.json 接口返回空 JSON 或超时,--retry 只会让 Composer 对同一个坏地址反复请求三次。真正该做的是切换源或清缓存。
- 先验证镜像可用性:
curl -fsSL --max-time 3 https://mirrors.aliyun.com/composer/p2/monolog/monolog.json | jq -e 'has("packages")' - 确认镜像 URL 以
/结尾,否则 Composer 会拼出.../composer//packages.json导致 404 - 遇到
Content-Length mismatch,优先运行composer clear-cache,而不是加--retry - 多镜像 failover 要靠
composer.json中的repositories顺序 +"packagist.org": false实现,不是靠重试
实际部署中最容易被忽略的,是 PHP 底层 default_socket_timeout 和 Composer 的 http.timeout 之间的层级关系——前者是后者无法绕过的硬性天花板。










