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

在Java里日志与异常如何配合使用_异常日志规范解析

小芳大大_3229

小芳大大_3229

发布时间:2026-01-11 14:58:02

|

468人浏览过

|

来源于php中文网

原创

Java中日志与异常需互补:异常负责结构化错误传播,日志负责记录可追溯的上下文;底层异常不重复打日志,上层捕获后结合业务场景记录WARN/ERROR并带堆栈;日志须含业务动作、关键输入(脱敏)、完整堆栈;按故障严重性分级,杜绝空catch、拼接异常等反模式。

在java里日志与异常如何配合使用_异常日志规范解析

Java中日志与异常的配合,核心在于:异常是“发生了什么”,日志是“什么时候、在哪里、为什么发生”。二者不替代,而要互补——异常负责结构化错误传播和处理,日志负责可追溯、可分析的上下文记录。

异常该抛还是该记?明确分工

不是所有异常都需要记日志,也不是所有日志都要裹异常。关键看责任边界:

  • 底层抛出异常时,通常不自行打日志(如JDBC驱动抛SQLException、Jackson解析失败抛JsonProcessingException),避免重复记录;上层捕获后,结合业务上下文决定是否记录
  • 主动throw new XxxException()前,若已知是预期外的严重问题(如配置缺失、连接池耗尽),可先打ERROR日志再抛,确保即使异常被静默吞掉,也有迹可循
  • catch块里不做任何处理就直接throw e或throw new WrapperException(e),属于典型日志遗漏——至少应记录WARN或ERROR,并带上原始异常(用log.error("业务操作失败", e)而非log.error("业务操作失败: " + e))

日志内容必须包含可定位的关键上下文

只记“NullPointerException”毫无价值。一次有效的异常日志应至少包含三要素:业务动作、关键输入、异常堆栈。

  • 业务动作:比如“支付回调验签失败”“用户ID=12345查询订单超时”,而不是“服务出错”
  • 关键输入:脱敏后的请求参数、订单号、用户ID、接口路径等。避免打印完整request body或password字段
  • 异常堆栈:用带Throwable参数的log方法(如log.error(msg, throwable)),让SLF4J/Logback自动输出完整堆栈;切忌e.toString()或e.getMessage()拼接进字符串

按场景选日志级别,避免ERROR泛滥

日志级别混乱会导致告警失真、排查困难。基本原则:

Cn Password Generator
Cn Password Generator

安全的随机密码生成器。支持自定义长度、字符类型(大写/小写字母、数字、特殊符号),排除相似字符,批量生成。纯 Python 标准库,无需 API 密钥。

下载

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

  • ERROR:系统级故障、数据不一致、不可恢复的外部依赖失败(如DB连不上、Redis集群全宕)。必须有人跟进
  • WARN:异常可恢复但需关注,如第三方接口返回503临时不可用、缓存击穿触发DB加载、金额校验不通过但已拦截
  • INFO:正常业务流转的关键节点(如“订单创建成功,orderNo=ORD20240501001”),非异常场景下不用记异常
  • DEBUG:仅在开发/排查期启用,用于输出中间状态(如SQL参数、HTTP响应头),上线禁用

避免常见反模式

这些写法看似省事,实则埋下运维雷:

  • 空catch + println / log.info(e):掩盖问题,丢失堆栈,等于没记录
  • 在finally里打日志说“执行完成”却不区分成功/失败:无法判断是否真完成了
  • 用String.format拼接异常信息再打日志:堆栈丢失,且可能因参数为null导致二次NPE
  • 每个service方法开头log.info("enter xxx"),结尾log.info("exit xxx"):噪音大、无业务语义,建议用AOP+注解统一处理

规范不在多,在准——每次打异常日志,问自己一句:运维看到这条日志,能不能在5分钟内定位到代码行、参数值、上下游依赖状态?答案能肯定,才算到位。

热门AI工具

更多
切问学术

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

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

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

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

DeepSeek

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

WorkBuddy

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

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

3803

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

811

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

989

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

5621

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2583

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

5600

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

7361

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

1010

2024.04.29

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

80

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
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