更换国内镜像源并调整超时设置可解决Composer“Operation timed out”问题,推荐全局配置阿里云等镜像,如:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/,并增加超时时间:composer config -g process-timeout 3600 和 http.timeout 600,同时检查代理设置与网络连通性,清除缓存后重试。

Composer 出现 "Operation timed out" 错误,通常是因为网络请求包下载或元数据获取时连接不到远程服务器。这类问题多发于国内用户访问国外镜像源(如 packagist.org)时受网络环境影响。解决方法主要围绕更换镜像源、调整超时设置和优化网络配置展开。
使用国内镜像源加速访问
最有效的方式是将默认源替换为国内镜像,例如阿里云、Laravel China 或腾讯云提供的 Composer 镜像。
临时切换镜像(单个项目):
composer config repo.packagist composer https://mirrors.aliyun.com/composer/全局设置镜像(推荐):
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/执行后所有项目都会通过该镜像拉取包,大幅提升下载速度并降低超时概率。
增加超时时间限制
如果无法完全避免网络波动,可手动延长 Composer 的 HTTP 超时时间。
- 修改全局配置:composer config -g process-timeout 3600
- 设置 HTTP 超时:composer config -g http.timeout 600
这两个参数分别控制脚本执行和 HTTP 请求的最大等待时间,适当调高可防止因慢速网络中断操作。
检查网络与代理设置
某些公司或校园网络存在防火墙或强制代理,可能干扰 HTTPS 连接。
- 确认能否正常访问 https://packagist.org
- 若需使用代理,配置环境变量:export http_proxy=http://proxy.example.com:8080
- Windows 用户可在系统中设置代理,或在命令行中临时指定
也可在 composer.json 中显式配置代理:
composer config -g github-protocols https清除缓存并重试
旧的缓存数据可能引发异常连接行为。
composer clear-cache清空后重新运行安装命令,让 Composer 重新建立网络连接和文件下载流程。
基本上就这些。换源 + 调超时能解决绝大多数超时问题,配合网络排查更稳妥。










