跳转到主内容
极星编程网:以代码为星,赴技术山海!

在Java中如何实现日志记录功能_Java日志工具项目说明

新项目应选用 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 脏数据。 elasticsearch-9.4.0 win PHP中文网提供Elasticsearch 9.4.0 Windows 版本压缩包下载解压即用,内置 OpenJDK 无需额外配置 Java 环境。该版本重磅推出原生 Prometheus 支持、正式版 Elastic Workflows 以及基于 NVIDIA cuVS 的 GPU 加速向量索引,大幅提升 AI 检索与可观测性能力。建议前往官网下载,快速体验极速搜索与强大的数据分析功能。 下载 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% 以上,排查时优先盯死它们。

相关文章