先通过composer update -vvv查看详细日志,判断卡在依赖解析、下载或安装阶段;若卡下载则切换腾讯云、阿里云等国内镜像源;最后清空缓存composer clear-cache并检查process-timeout超时设置,通常可解决网络、配置或环境导致的卡顿问题。

当composer update卡住不动时,通常由网络、配置或环境问题引起。直接加详细日志是最快定位问题的方法。
开启详细日志观察卡点
使用高阶verbose参数运行命令,查看具体停在哪一步:
-
composer update -vvv:显示详细过程,包括正在处理的包和网络请求 - 观察输出最后几行,判断是卡在“Resolving dependencies”、“Downloading”还是“Installing”阶段
- 若卡在下载,大概率是网络或镜像源问题;若卡在依赖解析,可能是版本约束太复杂
更换国内镜像源加速下载
默认源在国外,容易因网络波动卡住。切换为国内全量镜像可显著提升稳定性:
-
腾讯云镜像:
composer config -g repos.packagist composer https://mirrors.cloud.tencent.com/composer/ -
阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ -
phpComposer镜像:
composer config -g repo.packagist composer https://packagist.phpcomposer.com
设置后重新执行composer update -vvv,看是否恢复正常。
清空缓存与检查超时设置
Composer缓存损坏或超时阈值过低也会导致假死:
- 清空缓存:
composer clear-cache或删除~/.composer/cache目录 - 检查进程超时时间:
composer config -g process-timeout,默认300秒(5分钟) - 如需更长等待时间,可设为更高值:
composer config -g process-timeout 1800
基本上就这些。先看日志,再换源,最后清缓存调超时,多数卡顿问题都能解决。










