终结构建进度假死：配置Composer实时输出依赖拉取底层网络日志

终结构建进度假死：配置Composer实时输出依赖拉取底层网络日志

composer install卡在“Loading composer repositories”不动？直接看真实HTTP请求

很多时候，进度条卡在“Loading composer repositories”一动不动，问题根源往往不是网络慢，而是请求压根就没发出去。在默认模式下，Composer会把底层的HTTP交互细节全部“吞掉”，只给你一个看似卡住的假象。

这时候，加上 --verbose 参数才是正解。它会强制Composer暴露底层的curl行为，让你亲眼看到：GET https://packagist.org/packages.json 这个请求到底有没有发出去？是超时了，还是被DNS拦截了？或者服务器返回了403错误甚至一个空的响应体？

典型的错误现象不外乎两种：要么终端停在 Loading composer repositories 超过两分钟，没有任何报错和进度；要么就是突然中断，只抛出一句含糊的 Could not fetch，至于哪个URL、哪个包、哪一行代码出的错，一概不提。

• composer install --verbose 是最低成本的排查方式。它会打印每一步的请求URL、HTTP状态码、响应头（比如 Content-Type: application/json）以及JSON解析结果。
• 如果日志里出现了 Failed to decode JSON，那基本可以断定响应体不是合法的JSON格式——这通常意味着镜像源挂了、反向袋里配置错了，或者防火墙给你注入了一个HTML错误页面。
• 对于国内开发者，务必先确认镜像源是否真的生效。执行 composer config -g repos.packagist，它应该输出类似 {"type": "composer", "url": "https://packagist.org"} 的地址。如果显示的仍是 https://packagist.phpcomposer.com 这类已经停用的旧地址，那就需要手动切换了。
• 别被 --dry-run --verbose 的组合骗了：这个命令会跳过实际的网络请求，只做模拟解析，因此完全无法暴露真实的连接失败问题。

想 grep “Connection refused”或“SSL certificate problem”？必须重定向 stderr

这里有个关键细节：--verbose 和 -vvv 产生的所有调试输出，走的都是 stderr（标准错误流），而不是 stdout（标准输出流）。如果你不进行重定向，直接用 grep 去过滤，就相当于在对一个空文件进行操作，自然什么也查不到。

正确的写法应该是这样：

composer install --verbose 2>&1 | grep "Connection refused"
composer update -vvv 2>&1 | grep "SSL certificate"

几个关键点需要牢记：

• 2>&1 必须紧跟在命令后面，不能写成 composer install 2>&1 --verbose，错误的参数顺序会导致重定向失效。
• 在CI/CD环境中，建议加上 --no-ansi 参数，避免ANSI颜色控制码干扰文本匹配：composer install --verbose --no-ansi 2>&1 | grep "Resolving dependencies"。
• 觉得终端刷屏太快，看不清？可以用 head 或 tail 命令截断输出，比如 composer install -vvv 2>&1 | head -n 500 来查看前半段的初始化逻辑。

为什么 -vvv 才能看到依赖求解器的真实拒绝链？

只使用 --verbose 参数，你是看不到类似 “because php ^8.1 is required by monolog/monolog” 这种完整的依赖冲突回溯链条的。必须用上 -vvv，它才会触发SAT（可满足性）求解器的完整日志通道，输出诸如 Rejecting monolog/monolog:1.5.0 以及后续多行的 because... 原因链。

典型的应用场景包括：

• 执行 composer update -vvv 2>&1 | grep -A5 "Rejecting.*monolog"，可以快速定位是哪个包版本被拒绝了，以及依据的是哪条规则。
• 如果发现日志里反复出现 Skipped monolog/monolog (no matching package)？别急，往上翻几行，大概率能看到 because it requires php ^8.2 这样的信息——这说明问题可能不是包之间的冲突，而是你的PHP版本不匹配。
• 环境变量 COMPOSER_VERBOSE_SOLVER=1 composer update -vv 可以让你聚焦查看求解器的决策过程，但这通常只在已经确认存在依赖冲突、且 -vvv 的日志太长难以定位时使用。因为它不输出HTTP网络日志，只专注于回答“求解器当时是怎么想的”。

Docker 或 CI 中日志乱码/缺失？TERM 和输出流要提前对齐

在Docker容器里运行 composer install -vvv，有时会看到一堆乱码、换行错位，甚至日志直接消失。这通常不是Composer本身的bug，而是因为终端能力未正确声明，导致输出被截断。

几个实操建议：

• 运行Composer命令前，先设置 export TERM=xterm。这一点在使用Alpine基础镜像或旧版Ubuntu容器时尤其重要，否则ncurses这类库可能无法正确识别控制序列。
• 不要在Dockerfile的RUN指令里直接写 composer install -vvv。更好的做法是拆成两步：RUN export TERM=xterm && composer install -vvv --no-ansi 2>&1 > /tmp/composer-debug.log，将日志重定向到文件便于查看。
• 在GitHub Actions这类CI环境中，COMPOSER_NO_INTERACTION=1 这个环境变量必须显式设置。否则，某些插件可能会卡在等待交互式提示上，导致整个Job无限期挂起。
• 本地 ~/.composer/log 这个日志文件基本可以忽略——它只记录Composer初始化失败的信息，不包含任何一次 install 或 update 命令执行时的网络或依赖解析日志。

最后提一个最容易被忽略的细节：-vvv 日志里真正关键的信息，往往不在开头的HTTP请求部分，而是在结尾那几行 “Resolving dependencies through SAT” 之后出现的规则编号和 rejection 回溯里。很多人只扫了前面几屏日志就放弃了，殊不知答案可能就藏在最后100行里。