必须用composer update -vvv才能看到完整执行过程，它会输出依赖解析决策链、HTTP请求头/体、版本候选列表、缓存路径及插件钩子顺序；-v和-vv仅显示警告或简要信息，无法暴露冲突根因或网络失败细节。
composer update 时怎么看到完整执行过程？
默认情况下 composer update 只输出摘要信息，关键细节（如包解析冲突、HTTP 请求路径、回退尝试）全被隐藏。想定位为什么某个包没更新、为什么卡在某个步骤，必须开启详细日志。
最直接有效的是加 -vvv 参数——不是 -v 或 -vv，必须是三个 v：
composer update -vvv
它会打印出：依赖图构建过程、每个包的版本候选列表、HTTP 请求头与响应状态码、缓存读写路径、插件钩子触发顺序。尤其当出现 Could not fetch 或 Failed to download 时，-vvv 能立刻暴露是 DNS 解析失败、SSL 验证拒绝，还是镜像服务器返回了 404。
-
-v：只显示警告和错误 -
-vv：加少量调试信息（如命令执行路径） -
-vvv：完整日志，含所有网络请求和内部决策链
镜像配置不生效？检查 config 和 repo 的优先级
国内用户常配阿里云或腾讯云镜像，但 composer update -vvv 日志里仍显示访问 packagist.org，说明镜像没起作用。根本原因是 Composer 的镜像配置分两类，且优先级不同：
-
config.repo.packagist：全局或项目级设置，仅影响 packagist.org 官方源的代理，对其他仓库（如私有 GitLab）无效 -
repositories数组：可覆盖任意源，包括重写 packagist.org 为镜像地址，且优先级高于config.repo.packagist
推荐统一用 repositories 方式，避免混淆：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
]
}
运行 composer update -vvv 后，日志第一行会显示 Loading config file /path/to/composer.json，紧接着出现 Reading composer.json of packagist.org → 如果这里还是 packagist.org，说明 repositories 没写对或被其他配置覆盖。
调试镜像连通性：绕过缓存直连测试
即使镜像 URL 正确，也可能因 CDN 缓存、证书变更或本地 hosts 干扰导致实际请求失败。别只信 ping 或浏览器访问，要用 Composer 自己的 HTTP 客户端验证：
- 临时禁用缓存：
composer clear-cache && composer update -vvv - 强制走镜像且跳过 SSL 验证（仅调试用）：
COMPOSER_DISABLE_TLS=1 composer update -vvv - 查看真实请求域名：
composer update -vvv 2>&1 | grep -i 'GET http'，确认是否命中镜像地址而非原始域名
注意：如果日志中出现 Using GitHub API token，说明 Composer 正在调用 GitHub API 获取元数据——这类请求不受镜像配置影响，需单独处理 token 权限或 rate limit。
日志太多看花眼？用 grep 精准过滤关键线索
-vvv 输出动辄上万行，人工滚动效率极低。直接用管道过滤最可能出问题的环节：
- 查网络错误：
composer update -vvv 2>&1 | grep -E "(Failed|Connection refused|SSL|timeout)" - 查具体包行为：
composer update -vvv 2>&1 | grep "monolog/monolog" - 查镜像是否生效：
composer update -vvv 2>&1 | grep -A2 -B2 "mirrors\.aliyun"
真正麻烦的不是日志太长，而是错误发生在依赖解析早期（比如 Resolving dependencies through SAT 阶段），此时还没到下载环节，-vvv 也不会打印 HTTP 请求——得结合 composer why-not vendor/package 或 composer prohibits 进一步分析约束冲突。
