直接换国内镜像源、验证DNS解析、配GitHub Token可解决95%超时问题:Resolving卡住是DNS污染,需dig测试并切公共DNS;Downloading卡住须同步调http.timeout和process-timeout;Cloning卡住则因GitHub API限流,需配置github-oauth token。

直接换国内镜像源 + 验证 DNS 解析 + 配 GitHub Token,三步能解决 95% 的“超时”问题。报错不是真连不上,而是 Composer 在不同阶段卡在了不同环节——Resolving dependencies 是 DNS 问题,Downloading 是 HTTP 超时,Cloning 或 zipball 是 GitHub API 限流。
Resolving dependencies 卡住就是 DNS 污染
这一步根本没发 HTTP 请求,只查域名(比如 mirrors.aliyun.com)对应的 IP,所以改 http.timeout 完全无效。常见现象是终端停在 Resolving dependencies... 十几秒不动,ping 也超时。
- 用
dig mirrors.aliyun.com @8.8.8.8测试是否能返回 IPv4 地址;若无响应,说明本地 DNS 不可用或被污染 - 临时切公共 DNS:Linux/macOS 编辑
/etc/resolv.conf加nameserver 8.8.8.8;Windows 在网络适配器里手动设 - 检查
/etc/hosts(或C:\Windows\System32\drivers\etc\hosts)是否误写了127.0.0.1 mirrors.aliyun.com这类映射 - 手机热点直连测试一次——很多企业网会屏蔽境外域名解析,但热点通常通
Downloading 卡住要同时调两个 timeout
到这一步才真正发起 HTTP 请求,http.timeout 和 process-timeout 都得管。只调一个容易白忙:前者控制单次请求(如下载一个 ZIP),后者控制整个命令生命周期(含解压、校验等)。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 全局生效:
composer config -g http-basic-timeout 300(Composer 2.2+ 才支持,旧版用http.timeout) - 再补上:
composer config -g process-timeout 1800 - 临时调试更准:
composer install --timeout=1200 --http-basic-timeout=240 - 注意 URL 末尾必须带斜杠:
https://mirrors.aliyun.com/composer/✅,少斜杠会拼出非法路径
Cloning / zipball 卡住大概率是 GitHub 限流
日志里出现 Downloading https://api.github.com/ 或 Cloning into 'vendor/xxx' 后不动,基本不是网速问题,而是未认证请求触发了每小时 60 次的 API 上限。换镜像源对此完全无效。
- 去 GitHub Settings → Developer settings → Personal access tokens 创建 token,只勾选
repo - 写入全局配置:
composer config -g github-oauth.github.com <your_token_here></your_token_here> - 验证是否生效:
curl -H "Authorization: token <your_token_here>" https://api.github.com/rate_limit | grep limit</your_token_here>,返回值应为5000 - CI 环境务必在
composer install前显式执行该config命令,不能依赖缓存
镜像源配置失败常静默不生效
换源命令漏一个字符、少一个斜杠、键名写错,都会导致配置“看起来成功”,实际完全没走镜像。最典型的是把 repo.packagist 误写成 repos.packagist(多了一个 s)。
- 严格核对键名:
repo.packagist(单数 repo),type必须是composer,URL 必须以https://开头且末尾带/ - 验证是否真生效:
composer config -g repo.packagist输出必须是完整 JSON,如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 换源后必须清缓存:
composer clear-cache,否则旧缓存仍会复用失败地址 - 项目级
repositories字段优先级高于全局配置,记得检查composer.json里有没有硬编码的packagist.org或私有源
最容易被忽略的是:Resolving 和 Downloading 是两套完全独立的机制,DNS 和 HTTP 超时参数互不影响;GitHub Token 只对 api.github.com 生效,对 Git 克隆或镜像源下载无作用;而所有配置项一旦写错格式,Composer 就当它不存在——不会报错,只会默默走默认源。

















