composer install -v 会暴露真实网络链路卡点，强制执行dns解析→tcp连接→tls握手→http请求→响应解析全流程，精准定位如“connection timed out”或“ssl certificate problem”等具体环节；而composer diagnose仅做基础连通性检查，不验证真实链路。
Composer install -v 会暴露真实网络链路卡点
加 -v（或 --verbose）不是为了看更多日志，而是强制走一遍真实请求链路：DNS 解析 → TCP 连接 → TLS 握手 → HTTP 请求 → 响应解析。不加时 Composer 可能静默卡住或报模糊错误；加了之后你能一眼看到停在哪一环。
常见卡点现象：
-
Failed to connect to repo.packagist.org port 443: Connection timed out→ TCP 层不通，可能是防火墙、代理或 IPv6 fallback 导致 -
SSL certificate problem: unable to get local issuer certificate→ OpenSSL 证书路径错或 CA 包过旧 - 卡在
* Connected to packagist.org (2a03:2880::...)→ 正在等 IPv6 连接超时，实际是 IPv4 才该用
注意：composer diagnose 不验证真实链路，它只发一次 HTTP HEAD 到官方源（非镜像），且不走 TLS 握手，结果为 OK 完全不可信。
curl -v https://mirrors.aliyun.com/composer/ 是最直接的端口探测方式
Composer 实际访问的是镜像源的 /packages.json 和 /p2/ 下的元数据文件，不是根路径。直接测根路径可能返回 301 或 403，误判为“通”。必须测具体资源路径。
推荐命令：
curl -v https://mirrors.aliyun.com/composer/packages.json 2>&1 | grep -E "(Connected to|SSL handshake|HTTP/)"
关键判断依据：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 出现
Connected to ... (IPv6 地址)且后续无响应 → IPv6 超时问题，加CURL_IPRESOLVE=4临时绕过 - 卡在
* TLS handshake→ OpenSSL 版本太老（如 1.0.2k）或cafile路径无效 - 返回
HTTP/2 404或403→ 镜像 URL 路径变更（如阿里云已从/composer/改为/php/composer/）
端口连通性 ≠ DNS 解析成功，必须分层验证
“Connection refused”“Connection timed out”“Could not resolve host”看起来都是网络错误，但根因完全不同，不能统一调 http.timeout 或换镜像解决。
必须按顺序执行以下三步：
- 运行
ping packagist.org：返回unknown host→ DNS 失败，立刻换 DNS（如echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf） - 运行
curl -I https://packagist.org：卡住或报Failed to connect→ 防火墙/代理拦截，切手机热点快速验证 - 运行
curl -v https://mirrors.tuna.tsinghua.edu.cn/composer/：确认是否带末尾斜杠 —— 清华源少/就 404，阿里云源则不需要
注意：公司/学校网络常策略屏蔽 packagist.org 和 github.com，这不是你配错了，是出口策略本身不放行。
镜像配置生效前必须清缓存并检查优先级
换了镜像还报错，大概率不是镜像源问题，而是缓存或配置覆盖在捣鬼。
必须执行的操作：
- 运行
composer clear-cache：否则 Composer 可能从本地缓存读取已失效的地址 - 检查项目级
composer.json是否硬写了repositories→ 它的优先级高于composer config -g设置 - 验证是否真生效：
composer config -g repos.packagist（看全局）、composer config repos.packagist（不加-g，看当前项目） - 确认镜像 URL 结尾：清华源必须带
/，阿里云源不带也行，但 Laravel China 源必须是https://packagist.laravel-china.org（无尾部斜杠）
最容易被忽略的是：PHP 的 curl.cainfo 和 openssl.cafile 必须指向同一个有效的 cacert.pem 文件，且为绝对路径；只改一个，等于没配。
