composer install -v 会暴露真实网络链路问题，强制执行DNS解析→TCP连接→TLS握手→HTTP请求→响应解析全流程，精准定位卡点，而composer diagnose仅检查基础连通性与权限，不验证真实网络链路。
composer install -v 会暴露真实网络链路问题
默认 composer install 不输出网络细节，只报错或卡住。加 -v（或 --verbose）后，它会强制走一遍真实请求链路：DNS 解析 → TCP 连接 → TLS 握手 → HTTP 请求 → 响应解析。这时你能看到具体卡在哪一环，比如：Failed to connect to repo.packagist.org port 443: Connection timed out 或 SSL certificate problem: unable to get local issuer certificate。
注意：composer diagnose 的 OK 和这个 -v 输出不是一回事——前者只检查能否 ping 通、vendor 是否可写；后者才是真正“试装一次”的轻量级连通性验证。
用 curl 模拟 Composer 的镜像源请求
Composer 实际访问的是镜像源的 /packages.json 和 /p2/ 下的元数据文件。最直接的测法是：
curl -o /dev/null -s -w "%{http_code} %{time_total}s" --connect-timeout 5 https://mirrors.aliyun.com/composer/packages.json
关键点：
-
000表示 DNS 失败或连接超时（不是 HTTP 状态） -
200但time_total > 2.0就别当主力源用 -
403或404很可能是镜像路径变更（如阿里云已从/composer/改为/php/composer/） - 必须加
--connect-timeout 5，否则卡在 TCP 握手不返回
IPv6 导致卡在 Resolving dependencies 怎么确认？
这不是网络慢，而是 Composer 默认先尝试 IPv6 地址，超时（通常 1–3 秒）再 fallback 到 IPv4。上百个包叠加，就是几分钟无响应。验证方法：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
运行 curl -v https://packagist.org 2>&1 | grep "Connected to"，如果看到类似 Connected to packagist.org (2a03:2880:...) 的 IPv6 地址且后续卡住，基本就是它。
临时绕过方式：
- 命令前加环境变量：
CURL_IPRESOLVE=4 composer install - 或全局启用 IPv4 优先：
composer config -g platform.php 8.1 && composer config -g repos.packagist composer https://packagist.laravel-china.org
为什么 vendor/autoload.php 生成失败却没报错？
这是最隐蔽的网络问题表现：部分包下载成功，部分因超时静默跳过，Composer 回滚时不会提示“xx 包未写入”，而是生成一个残缺的 autoload.php —— 文件存在但为空或只有几行注释。
判断依据：
-
composer show报Could not find package in a package repository -
vendor/composer/installed.json是空文件或 JSON 格式错误 -
composer install --dry-run能跑通，但实际执行就失败
解决办法只有两个字：重来。删掉 vendor/ 和 composer.lock，再跑 composer install —— 别跳过 composer.lock，它锁定的是 commit hash，比仅靠 composer.json 更抗抖动。
