必须同时调高process-timeout和http-basic-timeout:前者管控整个命令生命周期(默认300秒),后者管控单次HTTP请求全过程(DNS、TLS、首字节、body传输,默认仅60秒),二者独立生效、不可替代,仅调其一无法解决下载卡在Downloading的超时问题。

单纯调大超时值不能解决“慢”,但能防止 Composer 在还没下完时就主动放弃;真正卡住的根源,90% 是镜像源不可靠或 DNS 解析失败,不是 timeout 数值小。
process-timeout 和 http-basic-timeout 必须一起调
Composer 有两个独立超时开关:process-timeout 管整个命令生命周期(默认 300 秒),http-basic-timeout 管单次 HTTP 请求全过程(DNS、TLS、首字节、body 传输,默认仅 60 秒)。只改一个,下载大包时仍会卡在 Downloading https://...。
- 临时生效:运行
composer install --timeout=1200 --http-basic-timeout=300(注意:--http-basic-timeout仅 Composer 2.2+ 支持) - 永久生效:执行
composer config -g process-timeout 1800和composer config -g http-basic-timeout 300 - 设为
0表示不限时,但容易无限挂起,不建议
卡在 Resolving dependencies 不是超时问题
这一步根本没发 HTTP 请求,只做 DNS 解析。调任何 timeout 都无效,必须查 DNS 是否可用。
- 运行
dig mirrors.aliyun.com @114.114.114.114,看是否返回 IPv4 地址 - 检查
/etc/hosts(Linux/macOS)或C:\Windows\System32\drivers\etc\hosts(Windows)是否误将镜像域名指向127.0.0.1 - 用手机热点测试——很多企业网会屏蔽
packagist.org域名,但热点通常直连通畅
镜像源配置错一个字符就等于没配
Composer 不报错,但静默失效。必须严格满足三项:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 键名是
repo.packagist(不是repos.packagist或repository) -
type值必须是composer(不能拼错,也不能省略) -
url必须是 HTTPS 且末尾带斜杠:https://mirrors.aliyun.com/composer/✅,少斜杠会拼出非法路径/composerpackages.json
验证是否生效:composer config -g repo.packagist 应输出完整 JSON,如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"};换源后必须执行 composer clear-cache,否则仍可能读损坏的本地 ZIP。
git 类包绕过镜像,需单独处理
只要 composer.json 里写了 "type": "git" 或依赖地址是 https://github.com/xxx,Composer 就直接走 GitHub,不经过镜像源。此时:
- 下载仍卡在
Downloading https://?那是http-basic-timeout在起作用,继续调大它 - 卡在
Cloning into ...?说明是 git clone 超时,process-timeout控制它,也得同步加大 - 想强制让 GitHub 包走 HTTPS 下载(避开 git 协议),可在
composer.json中加:"prefer-stable": true和"github-protocols": ["https"]
最常被忽略的是:换源后不清理缓存,或镜像 URL 少了个斜杠,结果配置看似成功,实则完全没生效。调试时优先用 --timeout 和 --http-basic-timeout 临时覆盖,确认可行再写入全局配置。










