卡在Downloading且报timeout错误,80%是镜像未生效与缓存残留导致的假性超时;应先验证镜像配置(composer config -g repo.packagist)、检查项目级repositories覆盖、运行--dry-run -v确认下载域名,再彻底清理元数据缓存(rm -rf ~/.composer/cache/repo/https---packagist.org/)、损坏ZIP及vendor/autoload.php和vendor/composer/,最后针对git包单独配置git-timeout和系统级Git超时。

composer install/update 卡在 Downloading 且报 timeout 错误
超时错误(如 file_get_contents(): SSL: Connection timed out 或 Failed to download vendor/package over https)80% 不是网速问题,而是镜像未生效 + 缓存残留共同导致的假性超时。直接调大 process-timeout 只是掩盖症状,不解决根本。
- 先确认是否真用了镜像:运行
composer config -g repo.packagist,输出必须是类似https://mirrors.aliyun.com/composer/或https://mirrors.tuna.tsinghua.edu.cn/composer/(注意清华源末尾必须带/,少一个就 404) - 检查项目级覆盖:打开项目根目录的
composer.json,搜"repositories"—— 如果存在,它会完全忽略全局镜像配置 - 验证下载链路:加
--dry-run -v运行一次,看日志里实际请求的是packagist.org还是镜像域名
clear-cache 后还是 timeout?重点清这三处
composer clear-cache 默认只删 ~/.composer/cache/files/、repo/、vcs/,但元数据索引和损坏 ZIP 往往卡在别处,导致重试仍失败。
- 手动删掉整个元数据缓存目录:
rm -rf ~/.composer/cache/repo/https---packagist.org/(Linux/macOS)或删%APPDATA%\Composer\Cache\repo\https---packagist.org\(Windows) - 定位并删除损坏 ZIP:
composer install -v日志末尾会显示失败包名(如symfony/console),进~/.composer/cache/files/找对应*symfony*console*.zip删除 - 删 vendor 中残留状态:
rm vendor/autoload.php+rm -rf vendor/composer/,再跑composer dump-autoload和composer install
git 类包绕过镜像,timeout 要单独处理
如果 composer.json 里有 "type": "git" 的包(比如直接引用 GitHub 仓库),Composer 会跳过所有镜像设置,直连 GitHub —— 此时改 process-timeout 或换源都无效。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 在
composer.json的config段加 Git 超时控制:"git-timeout": 600 - 同时设系统级 Git 超时(防卡死):
git config --global http.postBuffer 524288000和git config --global http.timeout 600 - 若仍失败,临时用 SSH 替代 HTTPS:
"url": "git@github.com:user/repo.git",并确保本地已配好 SSH key
缓存清理后首次安装变慢是正常现象
清完缓存再跑 composer install,你会明显感觉慢——这不是操作失误,而是设计使然:repo/ 缺失 → 重新拉 packages.json;files/ 缺失 → 所有 ZIP 全重下。尤其含大前端资源的包(如 laravel/ui)更拖时间。
真正容易被忽略的是:中断后 vendor/ 里那些看似完整的包文件,其实校验已失败,它们不会自动消失,也不会被 --dry-run 发现,却会在下次 install 时反复触发 Failed to extract 或 Content-Length mismatch —— 遇到这类错误,别犹豫,立刻删对应 ZIP + 清 repo/ + 重 dump autoload。










