讲师中心 微信公众号
AI工具推荐 视频效率加速

Java常用错误与异常日志类库与SLF4J

冬枫大大_8213

冬枫大大_8213

发布时间:2026-01-09 15:01:19

|

1026人浏览过

|

来源于php中文网

原创

SLF4J是日志门面而非实现,Logger是接口不能new;它通过StaticLoggerBinder绑定logback等具体实现,需确保classpath仅有一个绑定且配置正确。

java常用错误与异常日志类库与slf4j

SLF4J 是什么,为什么不能直接 new Logger

SLF4J(Simple Logging Facade for Java)不是日志实现,而是日志门面——它只定义 Logger 接口和绑定逻辑,不负责输出日志。直接调用 new Logger() 会编译失败,因为 Logger 是接口,没有构造方法。

真正干活的是底层绑定的日志实现,比如 logback-classic、slf4j-simple 或桥接器(如 slf4j-log4j12)。SLF4J 在运行时通过类路径上的 StaticLoggerBinder.class 找到具体实现。

  • 如果 classpath 下没有绑定实现,会看到警告:Failed to load class "org.slf4j.impl.StaticLoggerBinder"
  • 如果同时存在多个绑定(比如 logback-classic.jar 和 slf4j-log4j12.jar),SLF4J 会随机选一个并报错:Class path contains multiple SLF4J bindings
  • 桥接器(如 jul-to-slf4j)用于把其他日志 API(如 java.util.logging)重定向到 SLF4J,但需手动启用:SLF4JBridgeHandler.install()

常见错误:空指针、参数占位符不匹配、日志级别误用

SLF4J 的 logger.debug("User {} logged in at {}", userId, timestamp) 看似简单,但几个典型问题高频出现:

  • logger.error("Failed: {}", e) —— 把异常当普通参数传,会导致堆栈被 toString(),丢失完整 trace;正确写法是 logger.error("Failed", e)(第二个参数是 Throwable)
  • 占位符数量与参数数不一致,比如 logger.info("{}, {}, {}", a, b) 少传一个,SLF4J 不报错,但最后的 {} 会原样输出为字符串
  • 用 logger.isDebugEnabled() 包裹昂贵计算(如 JSON 序列化)是合理优化,但若里面调用了可能抛异常的代码,而外层没捕获,会导致 debug 关闭时异常仍被抛出——因为判断逻辑本身不抑制异常

Logback 与 Log4j2 的关键差异影响 SLF4J 使用方式

虽然都兼容 SLF4J,但底层行为差异直接影响日志可靠性:

chartjs-reporter
chartjs-reporter

此技能用于在用户需要将结构化数据(查询结果、CSV 摘要、JSON 记录或 Python 字典/列表)转换为独立的 HTML 页面时使用。

下载

立即学习“Java免费学习笔记(深入)”;

  • logback-classic 原生支持 SLF4J,配置文件是 logback.xml 或 logback-spring.xml;它的 %ex 能自动展开嵌套异常(Cause: ...),而 Log4j2 需显式用 %xEx
  • log4j2 通过 log4j-slf4j-impl 绑定 SLF4J,注意不是旧的 slf4j-log4j12(仅支持 Log4j 1.x);Log4j2 的异步日志(AsyncLogger)性能更好,但需额外引入 disruptor 依赖
  • Logback 的 RollingFileAppender 默认按时间滚动,但若 JVM 意外退出,可能丢最后一段日志;加 <immediateflush>true</immediateflush> 可缓解,代价是 I/O 增加

排查日志不输出的三步检查法

日志“消失”是最常被问的问题,按优先级逐项确认:

  • 检查 classpath 是否有且仅有一个 SLF4J binding:运行 mvn dependency:tree | grep slf4j,过滤掉 slf4j-api 后,确保只剩一个 slf4j-xxx 实现
  • 确认 logger 获取方式正确:private static final Logger logger = LoggerFactory.getLogger(MyClass.class);避免用字符串名(如 getLogger("MyClass")),否则无法继承包级日志级别配置
  • 验证 root logger 级别是否过低:比如配置了 root level="INFO",但代码里写的是 logger.debug(...),debug 日志必然被静默丢弃;临时改 root level="DEBUG" 可快速验证
<configuration>
  <root level="DEBUG">
    <appender-ref ref="CONSOLE"/>
  </root>
</configuration>

日志框架的“透明性”恰恰是它最易被忽略的复杂点:你没看见日志,往往不是代码错了,而是绑定、配置或级别在某个环节悄悄失效了。

热门AI工具

更多
墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2611

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

477

2026.01.26

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2155

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3302

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1116

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

3779

2025.09.10

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

4604

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

5977

2024.08.01

剧云故事大纲与分场规划教程
剧云故事大纲与分场规划教程

本专题讲解剧云梗概与多级大纲功能,覆盖全局、分集、分场结构生成,以及主线冲突、剧情节点和场次顺序调整。

0

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn