java.util.logging可快速启用基础日志,但需显式添加ConsoleHandler并设级别;捕获异常应使用log(Level, msg, throwable)保留堆栈;FileHandler需设append=true防覆盖;生产推荐Log4j2替代。

用 java.util.logging 快速启用基础日志
Java 标准库自带 java.util.logging(JUL),无需引入第三方依赖就能记录日志。它适合轻量项目或教学演示,但默认配置输出到控制台且格式简陋,容易误以为“没生效”。
- 默认
Logger.getLogger("MyApp")会继承根处理器,但根 Handler 可能被 JVM 启动参数关闭(如某些 IDE 默认禁用) - 务必显式添加
ConsoleHandler并设置级别:Logger logger = Logger.getLogger("MyApp"); logger.setLevel(Level.INFO); logger.addHandler(new ConsoleHandler()); -
INFO级别以下(如FINER)默认不输出,别只写logger.finer("debug")就以为能看到
捕获异常时用 logger.log(Level.SEVERE, msg, throwable) 而非字符串拼接
IO 操作(如 FileInputStream、ObjectOutputStream)极易抛出异常,直接打印堆栈容易丢失上下文。用带 Throwable 参数的重载方法,才能让日志包含完整调用链。
- 错误写法:
logger.severe("read failed: " + e.getMessage())→ 堆栈丢失,无法定位哪一行 IO 出错 - 正确写法:
logger.log(Level.SEVERE, "Failed to read config file", e)→ 日志中自动附加e.printStackTrace()式详情 - 注意:
msg字符串里不要提前调用e.toString()或e.getStackTrace(),会重复或截断
文件 IO 场景下避免日志器阻塞主线程
当使用 FileHandler 写入磁盘日志时,若未配置异步或缓冲,频繁日志可能拖慢 IO 流处理(比如批量读取上百个文件时每读一个都记日志)。
- 同步写文件风险:日志写入失败(如磁盘满、权限不足)会导致
IOException直接抛出,打断当前业务逻辑 - 缓解方式:用
MemoryHandler缓冲再刷盘,或改用AsyncLogger(需 Log4j2) - 若坚持用 JUL 的
FileHandler,至少设new FileHandler("app.log", true)的append=true,否则每次重启覆盖旧日志
Log4j2 替代 JUL 是更现实的选择
真实项目中,java.util.logging 很少单独使用——它的配置能力弱、MDC 支持差、与 Spring 等框架集成生硬。Log4j2 是目前 Java 生态最主流的日志门面+实现组合。
立即学习“Java免费学习笔记(深入)”;
- 只需加两个依赖:
log4j-api(门面)和log4j-core(实现),比 SLF4J + Logback 更少冲突 - 配置
log4j2.xml可精确控制:不同包用不同级别、IO 异常单独归档、JSON 格式输出供 ELK 收集 - 特别注意:
log4j-core曾有严重 RCE 漏洞(CVE-2021-44228),务必用 2.17.1+ 版本,且禁用JndiLookup
复杂点不在“怎么打日志”,而在“日志是否在异常发生瞬间写入、能否关联请求上下文、磁盘故障时是否静默降级”。这些细节往往等线上出问题才暴露。










