Java Logger日志记录器的日志文件大小限制

Java Logger 日志文件大小限制

JUL FileHandler 的关键配置

• 使用 java.util.logging.FileHandler 可通过配置项对单个日志文件的大小进行限制，并在达到阈值时自动滚动生成新文件。
• 核心参数如下：

• 当文件达到 limit 时，当前文件会被关闭并“轮转”出去，随后新建一个文件继续写入；历史文件按生成号递增命名。若未显式使用 %g 且 count > 1，生成号会自动附加到文件名末尾。以上行为由 JUL 的 FileHandler 定义与默认配置决定。

最小可用配置示例

• 将单个日志文件限制为 10 MB，保留最近 5 个历史文件，使用简洁文本格式：
  • 在 logging.properties 中：
    • handlers=java.util.logging.FileHandler
    • java.util.logging.FileHandler.pattern=%h/app.log
    • java.util.logging.FileHandler.limit=10485760
    • java.util.logging.FileHandler.count=5
    • java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
    • java.util.logging.FileHandler.append=true
  • 说明：上述配置将日志写入用户主目录的 app.log，达到 10 MB 后滚动，最多保留 5 个文件（app.log、app.0.log、app.1.log…），新日志继续写入 app.log。

按日期与大小组合滚动

• 若需要按日期与大小共同控制（例如每天或当文件达到阈值时滚动），JUL 的 FileHandler 本身不直接提供“按时间+按大小”的双触发策略；常见做法是：
  • 使用 SizeBasedTriggeringPolicy（大小触发）+ TimeBasedTriggeringPolicy（时间触发）的组合（在 Log4j2 等框架中很常见），或
  • 在文件名模式中加入日期占位符（如 %d{yyyy-MM-dd}），并配合按大小滚动与合理的 count，实现“按天分目录/分文件 + 当天内按大小滚动”的效果。
• 示例思路（概念）：
  • 将 pattern 设为类似：logs/app-%d{yyyy-MM-dd}.%g.log
  • 设置 limit 与 count，使“当天日志”在达到大小阈值时生成新文件（%g 递增），而跨天时因文件名中的日期变化自然切到新文件。
• 注意：JUL 的默认行为以“大小触发 + 固定数量的历史文件”为主；若业务强依赖“按天+按大小”的精细策略，优先考虑使用 Log4j2 或 Logback 的滚动策略来实现。

常见注意点

• 版本与默认值差异：不同 JDK 版本或发行版对 FileHandler.count 的默认值可能不同（有资料显示为 1，也有为 10000），上线前建议在目标环境打印或查询实际配置，避免因默认值过大导致磁盘被占满。
• 单位与换算：limit 以字节为单位，设置 10 MB 时应写为 10 * 1024 * 1024 = 10485760；0 表示不限制。
• 历史文件清理：JUL 通过 count 控制保留的历史文件数量，超过数量的最旧文件会被覆盖；若需要按“天数”或“总容量”更细粒度地清理，需结合外部脚本或使用更高级的日志框架策略。