-vvv 是 Composer 最底层调试开关,暴露 cURL 请求、SAT 解析器决策等细节,但卡顿需分层排查:网络问题(如 packages.json 下载卡住)优先验证 curl 连通性或换镜像;SAT 阶段卡住则检查约束冲突;gzip 解压失败多因代理篡改或缓存损坏;还需注意 config.verbose 关闭、platform 误配、内存不足及 xdebug 干扰。
-vvv 是 Composer 最底层的调试开关,能暴露 cURL 请求、SAT 解析器决策、未压缩元数据流和临时路径——但不是所有卡顿都靠它解决,得先看卡在哪一层。
卡在 Downloading https://repo.packagist.org/packages.
js
on?这是网络问题,不是日志没开够
执行
后停在这行,说明底层 cURL 已发起请求,但 DNS 查询、TLS 握手或响应体接收失败。此时
日志本身是生效的,只是它不打印 socket 超时细节。
先用
单独验证网络连通性
国内用户优先换镜像:
若仍卡住,检查是否启用了代理(
)或系统级 SSL 证书异常
PowerShell 下长日志易被截断,改用
或加
分页查看
看到 Resolving dependencies through SAT 但没后续?依赖求解器真卡住了
会显示约束条件(如
),而
才会逐行打印 SAT 求解器如何排除某个包的某个版本——比如 “monolog/monolog 2.0.0 excluded by your root
composer
.
json
require (^3.0)”。
若卡在此阶段,大概率是版本约束太紧或存在隐式冲突,不是网络问题
加
看耗时:
,确认是不是 90% 时间花在解析上
临时绕过平台限制验证:
,排除 ext-zip、
php
版本等干扰
别忽略
配置:若写了不存在的扩展(如
),
会立刻报错退出,根本不会进入 SAT 阶段
日志里出现 Failed to decode response: zlib_decode(): data error?gzip 响应损坏了
这通常发生在中间代理(如公司
防火墙
、Charles/Fiddler)篡改了响应体,或本地缓存损坏。cURL 收到了 gzip
编码
内容,但解压失败。
阿里云AI平台
阿里云AI平台
下载
加
排除插件干扰:
清空元数据缓存:
,再重试
设
环境变量
禁用压缩:
如果用了自定义镜像,确认其返回的
是否完整——
阿里云
镜像偶发此问题,可临时切回官方源验证
执行 -vvv 还是只输出几行?检查 config.verbose 和 --no-config
设为
会强制屏蔽所有 verbose 输出,优先级高于命令行参数;而
中误配的扩展也会让
提前崩溃。
运行
,重点查
和
临时绕过全部配置:
内存不足时 Composer 可能静默中断,尤其在
下日志本身吃内存,加
CI 环境中 xdebug 可能掩盖真实堆栈,加
再试
真正难调的不是日志不够多,而是不知道该信哪一行——
里混着 cURL debug、JSON 解析错误、SAT 回溯日志和临时路径,得结合
定位耗时点,再用
锁定冲突源头。否则光扫几百行日志,反而错过第一行关键线索。
composer install -vvv-vvvcurl -v https://repo.packagist.org/packages.jsoncomposer config -g repo.packagist composer https://mirrors.aliyun.com/composer/COMPOSER_HTTP_PROXYcmd2>&1 | more-vvphp: ^8.1-vvv--profilecomposer update -vvv --profilecomposer update -vvv --ignore-platform-reqsconfig.platform"ext-foobar": "1.0"-vvv--no-pluginscomposer update -vvv --no-pluginscomposer clear-cacheCOMPOSER_NO_INTERACTION=1 COMPOSER_HTTP_PROXY="" composer update -vvvContent-Encoding: gzipconfig.verbosefalseconfig.platform-vvvcomposer config --listconfig.verboseconfig.platformcomposer install -vvv --no-config-vvvCOMPOSER_MEMORY_LIMIT=-1COMPOSER_DISABLE_XDEBUG=1-vvv--profilecomposer prohibits