在Java里如何使用Logger进行日志输出_Java日志API基础说明

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.Loggerorg.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 能做基础滚动,但能力有限:

  • FileHandler("app.log", true) 支持追加,但不会自动切分
  • 要用滚动,得组合 SimpleFormatter + 继承 FileHandler 自定义,或改用 java.util.logging.FileHandler 的构造参数:FileHandler("app.%g.log", 10000000, 5, true) 表示单个最大 10MB、最多 5 个轮转文件
  • 注意:JDK 的日志滚动不支持按日期命名(如 app.2025-06-01.log),这是 logback/log4j2 的功能

真正上线前,别只靠 ConsoleHandler 验证逻辑是否跑通;没落盘的日志,在进程崩溃或容器重启后就彻底消失了。