Composer install卡住且CPU拉满,大概率是vendor/或项目路径中存在循环软链接,导致文件递归扫描陷入死循环;可用find -maxdepth 10 -follow -name '*' 2>&1 | grep "Too many levels"定位出口点,再逐层ls -la和readlink -f排查,修复后须手动删除vendor/composer/目录。

为什么 composer install 卡住不动,CPU 拉满?
这大概率是软链接(symlink)在 vendor/ 或项目路径中形成了循环引用,Composer 在递归扫描文件时陷入死循环。它不会报错,也不会超时退出,只会在 Installing dependencies 阶段卡死,strace 可见大量 openat 和 readlink 调用反复跳转。
怎么快速定位循环软链接?
别依赖 find -type l —— 它只找软链接,不验证是否成环。真正有效的是用 find 的 -follow 选项配合深度限制,触发内核级循环检测:
find vendor/ -maxdepth 10 -follow -name '*' 2>&1 | grep "Too many levels of symbolic links"
如果输出类似:find: ‘vendor/foo/bar’: Too many levels of symbolic links,就说明路径 vendor/foo/bar 是循环链的出口点。顺着这个路径往上查 ls -la,逐层看 readlink -f 结果,通常 3–4 层内就能暴露哪个软链接指向了父目录或自身。
- 重点检查
vendor/autoload.php是否被重定向到项目根目录下的某个 symlink - 留意开发中手动创建的
vendor/mylib→../mylib这类链接,尤其当mylib内部又包含指向../../vendor的链接时 -
composer.json中的"repositories"若用了path类型且路径含 symlink,也会在create-project或update时触发
composer install --no-plugins --no-scripts 有用吗?
没用。循环发生在 Composer 自身的依赖解析和文件遍历阶段,早于插件和脚本执行。加这些 flag 只是跳过后期动作,卡点不变。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
真正有效的临时绕过方式是:
- 删掉
vendor/,再用strace -e trace=openat,readlink -f composer install 2>&1 | head -n 500观察前几百次路径访问,找重复出现的路径片段 - 设置环境变量
COMPOSER_DISABLE_XDEBUG=1,避免 xdebug 加重循环开销(虽不解决根本,但能让卡顿更易复现) - 改用 Composer 2.5+,它对 symlink 循环做了基础防护 —— 会抛出
Symfony\Component\Finder\Exception\AccessDeniedException而非静默卡死(但前提是循环出现在 Finder 扫描范围内,不是底层RecursiveDirectoryIterator层)
修复后还要注意什么?
Composer 不会自动清理已损坏的 vendor/composer/autoload_*.php 缓存文件。即使软链接已修正,下次 install 仍可能因旧缓存加载失败而报 Class not found。必须手动删掉整个 vendor/composer/ 目录,再重装。
更隐蔽的问题是:某些 IDE(如 PHPStorm)或 LSP 服务会在后台持续监听 vendor/,它们自己也可能因 symlink 循环触发无限 watch 事件,导致系统响应变慢 —— 这时候 Composer 没卡,但你感觉“整个项目变卡”,容易误判。










