java Logger 日志记录器为何丢日志

在 Java 中使用 java.util.logging.Logger（JUL，即“Java 自带的 Logger”）时，“丢日志”是一个很常见的问题，通常不是真的“丢了”，而是被过滤、被覆盖、被异步吞掉或配置不对。下面按最常见原因 → 原理 → 解决办法系统说明。

一、最常见原因汇总（先记住这 6 点）

1. 日志级别被限制（Level 不够）
2. Handler 的 Level 比 Logger 更严格
3. Root Logger / Parent Logger 覆盖了配置
4. 只配了 ConsoleHandler，但输出被吞
5. 异步日志 / 线程关闭导致未 flush
6. Logger 被重新创建或配置被覆盖

二、详细原因与解决方案

1️⃣ 日志级别不匹配（最常见）

Logger logger = Logger.getLogger("com.xxx");
logger.info("hello");

如果你没有配置，默认：

• Logger 级别：INFO
• Root Handler 级别：INFO

但一旦你写了：

logger.setLevel(Level.WARNING);

那 info() 就直接不输出。

✅ 解决：

logger.setLevel(Level.ALL);

2️⃣ Handler 级别比 Logger 更严格（很多人踩坑）

JUL 的日志是否输出，是 两级判断：

Logger Level  ✅
   ↓
Handler Level ✅

示例错误：

logger.setLevel(Level.ALL);
handler.setLevel(Level.WARNING); // INFO 被丢掉

✅ 解决：

handler.setLevel(Level.ALL);

3️⃣ Root Logger 覆盖子 Logger（隐藏坑）

JUL 是树形结构：

"" (root)
 └── com
     └── xxx

如果你只配了：

Logger.getLogger("com.xxx").setLevel(Level.ALL);

但 root handler 是 WARNING，仍然可能丢日志。

✅ 正确做法：

Logger root = Logger.getLogger("");
root.setLevel(Level.ALL);
for (Handler h : root.getHandlers()) {
    h.setLevel(Level.ALL);
}

4️⃣ ConsoleHandler 输出被“吞”

常见于：

• IDE 控制台
• Docker / nohup
• System.out 被重定向

现象：

• 代码执行了
• 文件没日志
• 控制台也没日志

✅ 解决：

FileHandler fh = new FileHandler("app.log", true);
fh.setLevel(Level.ALL);
logger.addHandler(fh);

5️⃣ 异步 / 多线程导致日志未刷盘

如果你：

• 用线程池
• 主线程先退出
• 或用自定义 AsyncHandler

就可能出现：

程序结束 → 日志还没写 → 丢失

✅ 解决：

handler.flush();
handler.close();

或确保 JVM 不提前退出。

6️⃣ Logger 被“重复创建 / 配置覆盖”

错误示例：

Logger logger = Logger.getLogger("x");
logger.setLevel(Level.ALL);

// 另一个类又来一次
Logger.getLogger("x").setLevel(Level.OFF);

JUL 的 Logger 是单例（按名字）。

✅ 建议：

• 统一在启动类配置
• 或用 logging.properties

三、推荐的标准配置方式（不丢日志）

使用 logging.properties

handlers=java.util.logging.FileHandler
.level=ALL

java.util.logging.FileHandler.level=ALL
java.util.logging.FileHandler.pattern=app.log
java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter

启动：

java -Djava.util.logging.config.file=logging.properties Main

四、如果你用的是 Log4j / Logback（不是 JUL）

如果你实际用的是：

• org.apache.log4j
• logback

那“丢日志”原因不同（异步队列、buffer、滚动策略等），可以告诉我你用的是哪一个。

五、一句话总结

Java Logger 丢日志，90% 是因为 Level 被过滤或 Handler 没配对。

如果你愿意，可以把：

• 使用的 Logger 类型（JUL / Log4j / Logback）
• 配置代码或文件
• 运行环境（IDE / Docker / Spring）

贴出来，我可以帮你精准定位是哪一行配置在丢日志。