FileHandler 的日志滚动仅支持按文件大小和数量控制,依赖 limit 和 count 同时显式设置;limit=0 禁用滚动,count=1 无滚动,count>1 启用编号归档;必须用 4/5 参数构造函数并设 append=true,且需实际写入日志才能触发检查。

FileHandler 的日志滚动机制靠什么控制
Java 原生日志框架 java.util.logging.FileHandler 本身不支持按时间(如每天)滚动,只支持按文件大小 + 文件数量的循环覆盖策略。关键参数是 limit(单个文件最大字节数)和 count(最多保留几个历史文件),二者必须同时设置才启用滚动。
常见误区是只设 limit 却漏掉 count,结果日志写满后直接抛 java.io.IOException: Stream closed 或静默失败——因为默认 count == 1,但初始化逻辑要求显式传入大于 0 的值才会启用轮转逻辑。
-
limit = 0:禁用大小限制,永不滚动(除非手动 close/reopen) -
count = 1:仅写入主文件,不生成.%g编号副本(即无滚动) -
count > 1:启用滚动,旧文件重命名为mylog.1、mylog.2… 最老的被删除
如何正确构造支持滚动的 FileHandler 实例
必须使用带 4 个参数或 5 个参数的构造函数,显式传入 limit 和 count,且 append = true 才能持续追加;否则每次 JVM 启动都会清空原文件。
Handler handler = new FileHandler(
"logs/app.log", // pattern,支持 %g(序号)、%u(唯一数)
10 * 1024 * 1024, // limit:10MB
5, // count:最多保留 5 个文件
true // append:追加模式
);注意:pattern 中若含 %g,会自动生成 app.log.0、app.log.1 等;若不含,则所有滚动文件都叫 app.log(靠内部重命名实现,但文件名不体现序号)。
立即学习“Java免费学习笔记(深入)”;
你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在
- 推荐用
"logs/app.%g.log",便于人工识别和 logrotate 配合 - 如果
limit设太小(如 1KB),会导致频繁滚动+重命名,影响 I/O 性能 - Windows 下路径分隔符建议用正斜杠
/或双反斜杠\,避免转义问题
为什么日志没滚动?排查这三处硬性条件
即使代码写了 new FileHandler(..., 1048576, 3, true),仍可能不滚动。核心原因是:滚动触发依赖日志记录行为,且受 Handler 状态约束。
- Handler 必须已
setLevel(Level.ALL)且未被close()过——关闭后不会自动 reopen - 必须有日志实际写入(
logger.info("x")),空跑不触发检查 - 每次写入前,Handler 内部检查当前文件大小是否 ≥
limit,是则 close 当前流、rename 旧文件、open 新文件;这个过程不是原子的,高并发下可能因文件锁失败而跳过(尤其 Windows)
典型错误现象:IOException: The process cannot access the file because it is being used by another process —— 多线程/多 JVM 实例共用同一日志文件时必然发生,FileHandler 不支持跨进程共享。
替代方案:何时该放弃原生 FileHandler
如果你需要按天滚动、压缩归档、异步刷盘或 JSON 格式输出,FileHandler 就力不从心了。它没有内置压缩、不支持 yyyy-MM-dd 模板、无法在滚动时执行钩子(如通知运维)。
现实项目中更常用的是:
-
Logback的RollingFileAppender+TimeBasedRollingPolicy -
Log4j2的RollingRandomAccessFileAppender - 或用
java.util.logging配合第三方 Handler(如SEVERE级别发邮件 + 自定义Handler做定时归档)
原生 FileHandler 的滚动能力足够轻量级工具类或嵌入式场景,但一旦日志规模上升或运维要求变严,它的边界就非常清晰了:只管大小+数量,其余全得自己补。


















