0

0

解决Composer update导致磁盘空间不足(No space left on device)的清理技巧

穿越時空

穿越時空

发布时间:2026-01-06 14:45:43

|

971人浏览过

|

来源于php中文网

原创

应清理 Composer 缓存,尤其手动删除 ~/.composer/cache/vcs 目录;先用 df -h 和 du -sh 查占满位置,再执行 composer clear-cache && rm -rf ~/.composer/cache/vcs,最后可配置 cache-dir 到大分区预防。

解决composer update导致磁盘空间不足(no space left on device)的清理技巧

Composer update 时提示 No space left on device 怎么办

这不是 Composer 本身出错,而是系统临时空间被 composer update 过程中大量下载、解压、重写操作耗尽。尤其在 CI 环境或小容量 VPS 上极常见。关键不是删项目文件,而是清理 Composer 自己的缓存和临时目录。

先查清磁盘哪块被占满:df -hdu -sh ~/.composer/cache/*

运行 df -h 看哪个挂载点 100%;如果 /home/root 满了,大概率是 ~/.composer/cache 膨胀所致。Composer 缓存默认不自动清理,长期使用后可达数 GB。

  • du -sh ~/.composer/cache/vcs/:存放 Git 克隆副本,最占空间,尤其含大仓库(如 Laravel、Symfony)时
  • du -sh ~/.composer/cache/repo/:JSON 包索引缓存,通常较小
  • du -sh ~/.composer/cache/files/:已下载的 ZIP/TAR 包,可安全清理

执行精准清理:用 composer clear-cache + 手动删 vcs

composer clear-cache 会清 repofiles,但默认跳过 vcs —— 因为 Composer 认为它“可能被复用”。但实际中,vcs 缓存极少复用,且体积最大,必须手动处理。

composer clear-cache
rm -rf ~/.composer/cache/vcs/

注意:rm -rf 后不要加尾部斜杠(即写 ~/.composer/cache/vcs,而非 ~/.composer/cache/vcs/),避免误删上层目录。执行后可立即腾出 1–5 GB 空间。

预防下次再爆满:配置 cache-dir 到大分区 + 设置自动清理

如果 /home 分区小,但 /data/mnt 有空闲,可把缓存迁走:

代码小浣熊
代码小浣熊

代码小浣熊是基于商汤大语言模型的软件智能研发助手,覆盖软件需求分析、架构设计、代码编写、软件测试等环节

下载
composer config -g cache-dir /data/composer-cache

之后所有新缓存都写入该路径。另外,CI 脚本中建议加一行防呆:

composer clear-cache && rm -rf ~/.composer/cache/vcs

这个组合动作应作为 composer update 前固定步骤。别依赖 composer update --no-cache,它只跳过读缓存,仍会写临时文件到系统 /tmp,而 /tmp 往往更小。

vcs 目录的“可复用性”是 Composer 的乐观假设,在多数部署场景下不成立;不主动删它,下次 update 仍会复制一遍完整 Git 仓库。

相关专题

更多
PHP Symfony框架
PHP Symfony框架

本专题专注于PHP主流框架Symfony的学习与应用,系统讲解路由与控制器、依赖注入、ORM数据操作、模板引擎、表单与验证、安全认证及API开发等核心内容。通过企业管理系统、内容管理平台与电商后台等实战案例,帮助学员全面掌握Symfony在企业级应用开发中的实践技能。

78

2025.09.11

laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

316

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

270

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

366

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

366

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

81

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

64

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

65

2025.08.05

Golang 分布式缓存与高可用架构
Golang 分布式缓存与高可用架构

本专题系统讲解 Golang 在分布式缓存与高可用系统中的应用,涵盖缓存设计原理、Redis/Etcd集成、数据一致性与过期策略、分布式锁、缓存穿透/雪崩/击穿解决方案,以及高可用架构设计。通过实战案例,帮助开发者掌握 如何使用 Go 构建稳定、高性能的分布式缓存系统,提升大型系统的响应速度与可靠性。

1

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Laravel---API接口
Laravel---API接口

共7课时 | 0.6万人学习

PHP自制框架
PHP自制框架

共8课时 | 0.6万人学习

PHP面向对象基础课程(更新中)
PHP面向对象基础课程(更新中)

共12课时 | 0.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号