Java如何使用Logger输出日志

Java原生java.util.logging.Logger默认不输出日志，必须手动配置ConsoleHandler或FileHandler并正确设置日志级别，同时需严格区分JDK自带Logger与log4j2、SLF4J等第三方日志框架——它们包名不同、API独立、依赖和绑定机制迥异；推荐始终使用占位符（如{0}）而非字符串拼接格式化日志，以避免空指针、提升性能并实现惰性求值；生产环境务必启用带滚动策略的FileHandler（如按大小轮转），杜绝仅依赖ConsoleHandler导致日志丢失的风险。

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 能做基础滚动，但能力有限：

• 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 验证逻辑是否跑通；没落盘的日志，在进程崩溃或容器重启后就彻底消失了。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~