Java日志记录方法与工具详解

本文深入解析了Java日志记录的最佳实践，明确指出新项目应坚决摒弃配置僵硬、MDC支持弱、异步困难的java.util.logging（JUL），转而采用slf4j作为统一门面、logback作为高性能实现的黄金组合；同时系统讲解了如何正确引入依赖避免绑定冲突、通过TimeBasedRollingPolicy实现按天滚动日志、利用MDC安全注入请求级上下文（并规避线程复用导致的脏数据）、以及精准排查生产环境日志“消失”的三大元凶——日志级别误配、文件路径权限不足和相对路径陷阱，助你构建稳定、可观测、易维护的日志体系。

Java里该选 java.util.logging 还是 slf4j + logback

直接说结论：新项目别碰 java.util.logging（JUL），它配置僵硬、MDC 支持弱、异步日志难搞，连 Spring Boot 都默认弃用。主流选择是 slf4j 作门面 + logback 作实现，兼顾灵活性、性能和生态兼容性。

常见错误是只引 slf4j-api 却漏掉绑定实现，运行时抛 java.lang.NoClassDefFoundError: org/slf4j/impl/StaticLoggerBinder。必须确保 classpath 下有且仅有一个 binding，比如 logback-classic。

• slf4j-api：只提供 Logger 接口，编译期依赖
• logback-classic：运行时真正干活的，自带 slf4j-api 依赖
• 不要同时引入 log4j-slf4j-impl 和 logback-classic，会冲突

怎么让日志输出到文件并按天滚动

logback 的 RollingFileAppender 是标准解法，关键在 TimeBasedRollingPolicy。注意不是所有 rolling 策略都支持“按天”，FixedWindowRollingPolicy 是按序号轮转，不满足时间维度需求。

典型配置中容易忽略两点：一是 fileNamePattern 必须含日期占位符（如 %d{yyyy-MM-dd}），二是 file 属性指定的是当前活跃日志路径，不是模板。

<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
  <file>logs/app.log</file>
  <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
    <fileNamePattern>logs/app.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
    <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
      <maxFileSize>100MB</maxFileSize>
    </timeBasedFileNamingAndTriggeringPolicy>
    <maxHistory>30</maxHistory>
  </rollingPolicy>
  <encoder>
    <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
  </encoder>
</appender>

如何在日志里打印用户 ID 或请求 ID

靠 MDC（Mapped Diagnostic Context）。它本质是当前线程的 ThreadLocal，适合 Web 请求这种“一次调用贯穿多个方法”的场景。但要注意：线程复用（如 Tomcat 线程池、CompletableFuture）会导致 MDC 脏数据。

Spring Boot 用户建议用 Logbook 或自定义 Filter + OncePerRequestFilter 注入 request ID；纯 Servlet 项目务必在 filter 的 doFilter 结尾调用 MDC.clear()。

• 写入：MDC.put("requestId", "abc123")
• 日志 pattern 中引用：%X{requestId:-N/A}（:-N/A 表示空值时显示 N/A）
• 异步线程需显式拷贝：MDC.getCopyOfContextMap() + MDC.setContextMap()

为什么本地能打日志，上生产就没了

最常见原因是日志级别配置不一致或路径无写权限。logback 默认级别是 DEBUG，但很多生产 logback-spring.xml 会设成 WARN 或 ERROR，导致 info() 日志直接被丢弃。

另一个高频坑是相对路径：开发时 logs/app.log 写在项目根目录下没问题，但生产常以 systemd 或 Docker 启动，工作目录可能是 / 或 /app，导致日志写入失败且无报错——logback 默认静默忽略 IO 异常。

• 加 查看 logback 初始化过程
• 检查 logs/ 目录是否存在、属主是否为运行用户、磁盘是否满
• 避免用相对路径，改用绝对路径如 /var/log/myapp/app.log

MDC 跨线程丢失、日志级别误配、文件路径权限问题，这三类故障占线上日志失联的 80% 以上，排查时优先盯死它们。

今天关于《Java日志记录方法与工具详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！