Composer install 卡在“Operation timed out”的根本原因是网络链路阻断或延迟，而非工具本身故障；常见于国内未配镜像、DNS污染、代理残留或防火墙拦截，需切换可信镜像源并排查本地网络干扰。
为什么 Composer install 会卡在 “Operation timed out”
根本原因不是 Composer 本身出错，而是它默认通过 HTTPS 访问 packagist.org（或你配置的镜像源）时，DNS 解析、TLS 握手或后续包下载阶段被本地网络阻断或严重延迟。常见于国内未配置镜像、DNS 污染、代理设置残留、或公司防火墙主动丢弃长连接。
检查并切换到国内可信镜像源
Packagist 官方源在国内直连极不稳定，必须显式切换。优先使用清华、阿里或腾讯镜像——它们同步及时且支持 HTTPS。
- 全局替换（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 仅当前项目替换：
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/
- 验证是否生效：
composer config repo.packagist
应输出对应镜像 URL，而非https://packagist.org
排查本地网络干扰项
即使用了镜像，仍超时，说明请求根本没发出去或被中间设备拦截。
- 关掉系统代理（尤其是 Windows 的“自动检测设置”或 macOS 的 PAC 脚本），Composer 不读系统代理，但某些网络环境会强制劫持 HTTPS 流量
- 临时关闭杀毒软件或企业级终端防护（如 360、火绒、CrowdStrike），它们常深度扫描 HTTPS 连接导致握手超时
- 执行
curl -I https://mirrors.aliyun.com/composer/packages.json
看是否能快速返回 HTTP 200；若失败，说明是基础网络问题，非 Composer 配置问题 - 避免在公司内网或校园网首次运行
composer install，这类网络常限制境外域名解析或 TLS 版本
调整 Composer 超时与重试策略
镜像可用但偶尔抖动时，延长等待时间比反复失败更有效。
- 增大超时：执行
composer config -g process-timeout 3000
（单位秒，默认 300） - 启用重试：添加
composer config -g github-protocols ["https"]
强制走 HTTPS，避免 SSH 协议因密钥或 DNS 问题失败 - 禁用更新检查（减少请求次数）：
composer config -g notify-on-install false
- 如果仍失败，加
-vvv参数运行（如composer install -vvv
），看具体卡在哪一步——是packages.json下载，还是某个.zip包的 GET 请求
Composer 的超时问题本质是网络链路不可靠，不是工具缺陷。最常被忽略的是：以为换了镜像就万事大吉，却没关掉后台悄悄运行的代理软件或安全策略。真遇到持续超时，先用 curl 直接测镜像地址，比反复改 Composer 配置更快定位根因。
