终结构建进度假死：配置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行里。
