Composer update超时需分三层定位:卡在Resolving dependencies是DNS或镜像问题,调http-basic-timeout无效;卡在Downloading才需设http-basic-timeout 300~600;卡在Executing command则调process-timeout。

“Composer update 超时”不是单一问题,而是三类不同超时叠加的结果:DNS/元数据拉取、HTTP 下载、脚本执行。必须先定位卡点,再调对应参数——改错 timeout 参数等于白忙。
卡在 Resolving dependencies 或 Updating dependencies 怎么办
这是 DNS 解析失败或 Packagist 元数据拉取慢,跟 process-timeout 无关,调它没用。
- 运行
composer update -vvv,盯住最后一行:如果停在Resolving dependencies,说明连不上packagist.org的provider-*.json文件 - 立刻验证 DNS:执行
dig packagist.org +short,若无响应或返回异常 IP,换 DNS(如114.114.114.114或223.5.5.5) - 确认镜像已生效:执行
composer config -g repo.packagist,输出应为https://mirrors.aliyun.com/composer/;若不是,重新设置并清缓存:composer clear-cache - 别信“临时加 --timeout=600”,这个参数对元数据拉取阶段完全不起作用
卡在 Downloading https://... 时该调哪个 timeout
这是单次 HTTP 请求卡住(TLS 握手、首字节等待、大包传输),process-timeout 不管这段,得用 http-basic-timeout(Composer ≥ 2.2)。
- 默认值是 60 秒,国内直连常因 TLS 慢握手或中间抖动超时,建议设为
300~600 - 临时生效:
composer update --http-basic-timeout=600 - 全局生效:
composer config -g http-basic-timeout 600 - 注意:旧版 Composer(http.timeout,不是同一个配置项
- 如果仍报
cURL error 28,检查 PHP 层:php -i | grep default_socket_timeout,若 ≤ 60,需同步调高
卡在 Executing command (CWD: ...) 或 Generating autoload files 后不动
这时才轮到 process-timeout 发挥作用,但它控制的是整个命令生命周期(含解压、运行 post-install-cmd、生成 autoloader 等)。
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
- 默认 300 秒太保守,复杂项目建议设为
1200(20 分钟)或更长 - 临时改:
composer update --process-timeout=1200 - 永久改:
composer config -g process-timeout 1200 - 常见干扰源:Laravel 的
php artisan config:cache卡在 APCu 未启用、WSL2 symlink 解析慢、PHPmemory_limit不足(建议 ≥ 1G) - 快速验证是否脚本导致:加
--no-scripts --no-plugins重试,若秒过,就去查composer.json里scripts部分
为什么镜像配置了还超时?优先级和缓存最容易被忽略
镜像不生效,90% 是因为配置被覆盖或缓存没清,不是镜像地址写错了。
- 项目级
composer.json中的"repositories"字段优先级高于全局config -g,哪怕只写了一行也会屏蔽镜像 - 必须执行
composer clear-cache,否则 Composer 会继续读本地失效缓存(尤其是 provider-*.json) - 验证是否真走镜像:运行
composer update -vvv,看日志里下载 URL 是否变成https://mirrors.aliyun.com/composer/... - Windows 用户注意路径中含空格或中文时,
path仓库会静默失败,不要混用
真正卡住的时候,-vvv 日志末行就是唯一诊断依据。网络层、HTTP 层、进程层三个 timeout 各管一段,混着调只会掩盖问题。镜像、DNS、PHP socket 配置、脚本逻辑,四者缺一不可——漏掉任何一个,调再久的 timeout 都只是在等下一个超时。










