Java日志切割核心是按大小或时间生成新文件,避免磁盘占满;手动实现需检查文件大小/日期、原子重命名、加锁防并发;生产环境推荐Logback的RollingFileAppender,支持时间/大小滚动、压缩、自动清理。

Java中实现日志文件切割,核心是控制单个日志文件大小或按时间周期(如每天)生成新文件,避免日志无限增长导致磁盘占满或排查困难。不依赖Log4j、Logback等成熟框架时,可基于java.io和java.nio.file手动实现;若已使用SLF4J+Logback,则优先配置内置的RollingFileAppender——更稳定、线程安全、支持压缩与删除策略。
手动实现按大小滚动切割
适用于轻量场景或学习理解原理。关键逻辑:写入前检查当前日志文件是否超过阈值(如10MB),超限则重命名旧文件、新建文件继续写入。
- 用
File.length()获取当前日志文件大小,对比预设上限(如MAX_SIZE = 10 * 1024 * 1024) - 切割时建议添加时间戳或序号后缀,例如
app.log.20240520.1,避免覆盖 - 使用
Files.move()配合StandardCopyOption.REPLACE_EXISTING确保原子性重命名 - 注意多线程写入:需对“判断+切割+写入”整个流程加锁(如
synchronized代码块或ReentrantLock)
手动实现按日期滚动切割
每天生成一个独立日志文件,文件名含日期(如app.log.20240520),便于归档和检索。
- 每次写入前,用
DateTimeFormatter.ofPattern("yyyyMMdd").format(LocalDate.now())获取当天日期标识 - 缓存当前生效的日期字符串和对应
PrintWriter或BufferedWriter,仅当日期变更时关闭旧流、打开新文件 - 首次启动或跨日切换时,需确保旧文件已关闭,再创建新文件流,防止句柄泄漏
- 可配合
ScheduledExecutorService每日零点触发清理任务(如删除7天前的日志)
推荐方案:用Logback配置自动滚动
生产环境强烈建议使用Logback(SLF4J绑定),它原生支持灵活滚动策略,且经过高并发验证。
立即学习“Java免费学习笔记(深入)”;
- 在
logback.xml中配置RollingFileAppender,指定TimeBasedRollingPolicy按天切分,或SizeAndTimeBasedRollingPolicy同时按大小和时间切分 - 设置
maxHistory="30"自动保留30天日志,totalSizeCap="3GB"限制总日志体积 - 启用
gzip压缩()节省磁盘空间app.%d{yyyy-MM-dd}.%i.gz - 无需改代码,只调用
Logger.info("xxx")即可,底层自动处理切割、压缩、清理
注意事项与避坑点
手动实现易忽略的细节,直接影响稳定性:
- 文件路径需使用绝对路径或确保相对路径基准正确(如基于
System.getProperty("user.dir")) - 日志切割时若进程异常退出,可能留下未关闭的文件流,造成磁盘空间无法释放——务必在
finally或try-with-resources中关闭 - Windows下文件被占用时
move会失败,需捕获AccessDeniedException并重试 - 不要在日志写入方法内部频繁创建
SimpleDateFormat(非线程安全),应声明为static final或改用DateTimeFormatter









