新项目应选用 slf4j + logback,而非 java.util.logging;因 JUL 配置僵硬、MDC 支持弱、异步难实现,而 slf4j+logback 灵活高效且生态完善,需确保 classpath 有且仅有一个绑定实现(如 logback-classic)。

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 属性指定的是当前活跃日志路径,不是模板。
立即学习“Java免费学习笔记(深入)”;
logs/app.log logs/app.%d{yyyy-MM-dd}.%i.log 100MB 30 %d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n
如何在日志里打印用户 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% 以上,排查时优先盯死它们。










