Composer install卡在/tmp写入失败,需依次检查/tmp空间与inode、用户写权限、缓存目录膨胀、parallel-downloads并发值及autoload误配临时路径。

composer install 卡在 tmp 目录写入失败?先查 /tmp 空间和权限
Composer 在下载、解压、安装过程中大量依赖系统临时目录(默认 /tmp),一旦该目录空间不足、inode 耗尽,或当前用户无写权限,就会出现静默卡顿、file_put_contents(/tmp/...) 报错、甚至中途退出但不提示原因。
常见现象包括:
- 执行
composer install时长时间无响应,最后报failed to open stream: No space left on device或Permission denied -
strace -e trace=openat,write php -r "require 'vendor/autoload.php';"显示反复尝试写入/tmp/composer_*文件失败 - 同一台机器上其他用户能正常安装,唯独你不行——很可能是
$COMPOSER_HOME或/tmp权限被改过
实操建议:
- 运行
df -h /tmp和df -i /tmp查看磁盘空间与 inode 是否满 - 确认当前用户对
/tmp有写权限:touch /tmp/test_composer_$$ && rm /tmp/test_composer_$$ - 若权限受限或空间紧张,可强制指定 Composer 临时目录:
COMPOSER_CACHE_DIR=/path/to/your/cache COMPOSER_HOME=/path/to/your/home composer install - 注意:不要把
COMPOSER_HOME指向 NFS 或远程挂载路径,I/O 延迟会放大问题
composer 临时文件没清理干净,缓存目录膨胀拖慢解析
Composer 会把包元数据、dist zip 缓存、HTTP 响应头等全堆在 $COMPOSER_HOME/cache 下。旧版本(尤其是 1.x)不会自动清理过期项,长期未清的缓存可能达数 GB,导致 composer install 启动时遍历缓存目录耗时剧增,尤其在 SSD 性能较差或 ext4 文件系统 inode 数量多的场景下更明显。
关键点:
-
composer clear-cache只清cache/files和cache/repo,但不会动cache/vcs(Git 克隆缓存)——这部分常占大头 - 如果项目频繁
composer update且含大量私有 Git 包,cache/vcs下会堆积几十个完整 Git 仓库副本 -
cache/repo/https---packagist.org(或镜像路径)里存的是压缩后的 packages.json,但若镜像 URL 配错(如少斜杠、协议不对),Composer 会不断拉取失败并重试,留下大量脏缓存
实操建议:
- 手动清理 VCS 缓存:
rm -rf $COMPOSER_HOME/cache/vcs(下次需要时会重建,但首次 clone 会稍慢) - 验证镜像是否真正生效:
composer config -g repo.packagist输出必须是完整 JSON,含"url": "https://mirrors.aliyun.com/composer/"(末尾带斜杠) - 定期跑
composer clear-cache && find $COMPOSER_HOME/cache -type f -mtime +30 -delete清理 30 天前的零散缓存文件
并发下载触发临时文件竞争,parallel-downloads 设太高反拖慢
Composer 2.2+ 支持 parallel-downloads 配置,默认仅 3,并发提至 8–10 确实能加速下载,但前提是临时目录 I/O 能扛住。设得过高(比如 20),多个进程同时往 /tmp 写临时 zip、同时解压、同时生成 autoload 文件,极易触发文件锁等待或 Too many open files 错误。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
典型表现:
- 安装中途报
file_put_contents(/tmp/...): failed to open stream: Resource temporarily unavailable -
lsof -u $USER | grep /tmp | wc -l显示打开文件数接近系统 limit(用ulimit -n查) - 磁盘 I/O wait 飙高,
iostat -x 1显示 %util 接近 100%
实操建议:
- 全局设为 10 是较稳妥值:
composer config -g parallel-downloads 10 - 若仍出错,降到 6 或 8;CI 环境中还可加
--no-autoloader --no-scripts把 CPU/I/O 密集操作后移 - 避免在低配容器(如 1C1G)里硬设高并发——Composer 并非纯网络工具,它解压、校验、写文件全是本地操作
- 别信“越大越好”,并发收益在 8–10 后急剧衰减,反而增加失败率
autoload 生成阶段反复扫描 /tmp 下的临时类路径
某些项目在 composer.json 的 autoload.classmap 或 autoload-dev.classmap 中误写了临时路径(如 "classmap": ["tmp/", "build/"]),或者用了动态生成类的测试工具(如 phpunit/phpunit 的 --generate-configuration 产出临时 bootstrap),会导致 composer dump-autoload(或 install 自动触发)时反复扫描这些目录,而这些目录下往往有大量小文件或符号链接,进一步加剧 /tmp 压力。
排查方式:
- 运行
composer dump-autoload -v,观察输出里是否出现扫描/tmp或build/类似路径 - 检查
composer.json的autoload和autoload-dev字段,确认没有包含任何临时、构建、测试输出路径 - CI 构建中若用
composer install --no-dev,但autoload-dev里仍有 classmap 规则,Composer 仍会解析它(只是不安装 dev 包)——这是个隐蔽坑
实操建议:
- 生产部署一律用
composer install --no-dev --optimize-autoloader --classmap-authoritative --no-autoloader,后续再补composer dump-autoload -o -a,彻底隔离临时路径干扰 - 本地开发时,用
autoload-dev仅覆盖tests/和src/下真实代码,删掉所有tmp/、var/、runtime/类路径 - 若项目必须动态加载临时类(如某些 CLI 工具),改用
spl_autoload_register()手动注册,别塞进 Composer autoload 体系
临时文件问题从来不是“清一次缓存就完事”,它横跨权限、空间、并发策略、autoload 配置四个层面;最容易被忽略的是:你以为在优化网络,其实瓶颈早卡在了 /tmp 的一次 stat() 调用上。










