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
排查本地网络干扰项
即使用了镜像,仍超时,说明请求根本没发出去或被中间设备拦截。
Delphi 7应用编程150例 CHM全书内容下载,全书主要通过150个实例,全面、深入地介绍了用Delphi 7开发应用程序的常用方法和技巧,主要讲解了用Delphi 7进行界面效果处理、图像处理、图形与多媒体开发、系统功能控制、文件处理、网络与数据库开发,以及组件应用等内容。这些实例简单实用、典型性强、功能突出,很多实例使用的技术稍加扩展可以解决同类问题。使用本书最好的方法是通过学习掌握实例中的技术或技巧,然后使用这些技术尝试实现更复杂的功能并应用到更多方面。本书主要针对具有一定Delphi基础知识
- 关掉系统代理(尤其是 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 请求
curl 直接测镜像地址,比反复改 Composer 配置更快定位根因。









