当composer update卡住不动时如何排查问题？

先通过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，看是否恢复正常。

Vheer

AI图像处理平台

260 查看详情

清空缓存与检查超时设置

Composer缓存损坏或超时阈值过低也会导致假死：

• 清空缓存：composer clear-cache 或删除~/.composer/cache目录
• 检查进程超时时间：composer config -g process-timeout，默认300秒（5分钟）
• 如需更长等待时间，可设为更高值：composer config -g process-timeout 1800

基本上就这些。先看日志，再换源，最后清缓存调超时，多数卡顿问题都能解决。

以上就是当composer update卡住不动时如何排查问题？的详细内容，更多请关注php中文网其它相关文章！