Composer在IPv6环境下拉依赖卡住主因是DNS返回AAAA记录后优先尝试不可达IPv6地址并超时，而非镜像问题；最有效解法是用COMPOSER_NO_IPV6=1跳过IPv6解析（2.2+原生支持），或配置use-ipv4 true，二者均精准控制Composer自身请求行为，避免系统级修改。
Composer 在 IPv6 环境下拉依赖卡住或失败，不是镜像“不支持双栈”，而是它默认尝试 IPv6 连接但 fallback 慢或失败——解决关键不在换镜像，而在绕过 IPv6 解析逻辑。
为什么“双栈镜像”说法容易误导
所谓“双栈支持的 Composer 镜像”并不存在独立技术标准。所有主流镜像（如 https://mirrors.aliyun.com/composer/）本身都监听 IPv4 和 IPv6 地址，但问题出在客户端：Composer 调用 PHP 的 curl 或 stream_socket_client() 时，若 DNS 返回 AAAA 记录，会优先试 IPv6；一旦该地址不可达（如路由不通、防火墙拦截、CDN 未开 IPv6），就卡在超时（默认 30 秒），而非秒级 fallback。
你看到的“镜像响应慢”，其实是底层在等 IPv6 连接超时后才切 IPv4，不是镜像服务器的问题。
COMPOSER_NO_IPV6=1 是最直接有效的开关
这是 Composer 2.2+ 原生支持的环境变量，它让 Composer 在发起 HTTP 请求前就跳过 IPv6 地址解析，全程走 IPv4，不依赖系统 DNS 设置或 cURL 版本。
- Linux/macOS：
COMPOSER_NO_IPV6=1 composer install - Windows PowerShell：
$env:COMPOSER_NO_IPV6="1"; composer install - Windows CMD：
set COMPOSER_NO_IPV6=1 && composer install
这个变量只作用于当前命令，不影响其他进程，CI/CD 中也推荐用它临时调试。比改 /etc/hosts 或关系统 IPv6 更安全、更精准。
use-ipv4 配置项和镜像源要配合使用
单独配镜像源（如 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/）不能解决 IPv6 解析延迟——如果本地网络 IPv6 不通，Composer 仍会先花 30 秒尝试连 [240e::...] 地址再 fallback。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
必须搭配协议控制：
- 项目级生效：
composer config use-ipv4 true（写入当前composer.json的config字段） - 全局生效：
composer config -g use-ipv4 true（写入~/.composer/config.json）
注意：use-ipv4 仅 Composer 2.2+ 支持；旧版本（1.x）必须用 COMPOSER_NO_IPV6=1。
别碰 /etc/gai.conf 或 CURL_IPRESOLVE=4
这些是系统或 cURL 层面的干预，实际效果不稳定：
-
CURL_IPRESOLVE=4依赖 libcurl ≥ 7.19.4 且 PHP 编译时启用 IPv6 支持，但 Composer 2.2+ 默认用 cURL 驱动，若你启用了 Guzzle 等自定义 HTTP 客户端，它就失效 -
/etc/gai.conf修改会影响整个系统（包括 Docker、K8s、PHP sockets 扩展），运维成本高，且在容器或 CI 环境中不可移植
真正需要控制的，只是 Composer 自己发请求时的行为——COMPOSER_NO_IPV6=1 或 use-ipv4 就是为此而生的，不要绕到系统层去调。
IPv6 兼容性问题的本质，是 fallback 机制不可控，而不是连接能力缺失。强制走 IPv4 不是倒退，是在过渡期最可控的落地选择。镜像源选阿里云或腾讯云，再加一层协议控制，基本覆盖所有国内常见网络场景。
