Java原生Logger默认不输出日志,需显式添加ConsoleHandler并设置level;注意区分java.util.logging.Logger与log4j2/slf4j;推荐使用占位符格式化日志;生产环境应使用FileHandler并配置滚动策略。

Java里Logger类默认不输出日志,必须配置Handler
直接用 Logger.getLogger("MyLogger") 获取实例后调用 info()、severe() 等方法,控制台通常什么也不打印——这不是代码错了,而是 JDK 自带的 java.util.logging.Logger 默认只把日志发给一个空的 Handler 链。它不会自动绑定控制台或文件输出。
- 必须显式添加
ConsoleHandler(否则日志被丢弃) - 要看到 INFO 及以上级别,得设置
logger.setLevel(Level.INFO)和handler.setLevel(Level.INFO)(两者缺一不可) - 默认的根 Logger 有
ConsoleHandler,但自定义 Logger 不继承它的 Handler,得自己加
Logger logger = Logger.getLogger("MyApp");
logger.setLevel(Level.INFO);
ConsoleHandler handler = new ConsoleHandler();
handler.setLevel(Level.INFO);
logger.addHandler(handler);
logger.info("这行现在能看到了");
log4j2 / slf4j 不是 JDK 原生 Logger,别混用类名
很多人搜“Java Logger”却在用 org.apache.logging.log4j.Logger 或 org.slf4j.Logger,它们和 java.util.logging.Logger 完全无关:包名不同、API 设计不同、配置方式也不同。IDE 自动导入时容易选错,导致编译通过但运行时报 NoClassDefFoundError 或静默失败。
- 用 JDK 原生 API:认准
import java.util.logging.Logger; - 用 log4j2:必须引入
log4j-api+log4j-core,且使用LogManager.getLogger() - 用 slf4j:只写门面接口
Logger,但必须绑定具体实现(如 logback-classic),否则报Failed to load class "org.slf4j.impl.StaticLoggerBinder"
格式化日志内容别用字符串拼接,用占位符
JDK 的 Logger 支持类似 SLF4J 的占位符语法,比如 logger.info("User {0} logged in at {1}", username, Instant.now())。这样做的好处不只是写法简洁:
- 参数未被实际使用时(比如日志级别被禁用),对象不会被构造或 toString(),避免无谓开销
- 避免因
username为 null 导致NullPointerException(原生拼接"User " + username + "..."会崩) - 注意:只支持
{0},{1}这种数字索引,不支持{}或{name}
logger.fine("Connection timeout after {0}ms", timeoutMs); // ✅ 安全高效
logger.fine("Connection timeout after " + timeoutMs + "ms"); // ❌ 级别禁用时仍执行拼接
生产环境慎用 ConsoleHandler,优先用 FileHandler 并配滚动策略
ConsoleHandler 适合开发调试,但生产系统中日志必须落盘、按大小/时间滚动、保留历史——JDK 自带的 FileHandler 能做基础滚动,但能力有限:
立即学习“Java免费学习笔记(深入)”;
-
FileHandler("app.log", true)支持追加,但不会自动切分 - 要用滚动,得组合
SimpleFormatter+ 继承FileHandler自定义,或改用java.util.logging.FileHandler的构造参数:FileHandler("app.%g.log", 10000000, 5, true)表示单个最大 10MB、最多 5 个轮转文件 - 注意:JDK 的日志滚动不支持按日期命名(如 app.2024-06-01.log),这是 logback/log4j2 的功能
真正上线前,别只靠 ConsoleHandler 验证逻辑是否跑通;没落盘的日志,在进程崩溃或容器重启后就彻底消失了。










