0

0

Java业务异常怎么设计_Java业务异常体系构建方案

P粉602998670

P粉602998670

发布时间:2025-12-30 01:19:32

|

997人浏览过

|

来源于php中文网

原创

应构建分层业务异常体系:业务异常(如余额不足)用BizException子类抛出,不打堆栈;系统异常(如NPE)需记录完整堆栈并修复;技术异常(如DB超时)统一兜底降级。

java业务异常怎么设计_java业务异常体系构建方案

Java业务异常不该直接 throw new RuntimeException("xxx"),更不能让底层技术异常(如 SQLException、RedisConnectionException)穿透到上层业务逻辑。一套清晰、分层、可捕获、易监控的业务异常体系,是保障系统健壮性与可维护性的基础。

明确区分三类异常:业务异常、系统异常、技术异常

这是设计起点。混淆会导致处理逻辑混乱、日志泛滥、告警失真。

  • 业务异常:代表业务规则被违反,属预期内失败,比如“余额不足”、“订单已取消”、“手机号已注册”。这类异常不打印堆,应被业务层主动捕获并转化为用户友好的提示。
  • 系统异常:指应用自身逻辑缺陷导致的非预期错误,如空指针、数组越界、NPE。这类异常必须记录完整堆栈,属于 bug,需修复。
  • 技术异常:来自外部依赖的故障,如数据库超时、HTTP 调用失败、MQ 发送异常。这类异常要统一兜底降级/重试,并标记为“外部依赖失败”,避免和业务逻辑混为一谈。

定义统一的业务异常基类与分层子类

避免满屏 new RuntimeException。建议定义一个抽象基类,再按模块或场景派生具体异常。

  • 基类 BizException 继承 RuntimeException,含 errorCode(String)、message、args(用于参数化提示),默认不打印堆栈(重写 fillInStackTrace() 返回 this)。
  • 子类示例:OrderBizException(订单域)、UserBizException(用户域)、PayBizException(支付域)。每个子类对应一组预定义 error code,如 ORDER_NOT_FOUND("ORDER_001")、INSUFFICIENT_BALANCE("PAY_002")。
  • code 建议采用“模块_编号”格式,便于日志检索、监控聚合、前端国际化映射。

全局异常处理器统一拦截与响应

用 @ControllerAdvice + @ExceptionHandler 拦截所有未被捕获的异常,按类型差异化处理:

StickerBaker
StickerBaker

免费开源的AI贴纸头像生成工具

下载

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

  • 捕获 BizException:返回 HTTP 200 + { "code": "PAY_002", "msg": "余额不足", "data": null };记录轻量日志(如 traceId + code + userId + orderId)。
  • 捕获 RuntimeException(非 BizException):返回 HTTP 500 + 通用错误码;记录 ERROR 级别日志 + 完整堆栈;触发告警(如企业微信/钉钉机器人)。
  • 捕获 IOException / TimeoutException 等技术异常:返回 HTTP 503 或自定义“服务暂不可用”码;记录 WARN 日志 + 依赖名 + 耗时;可集成熔断器(如 Sentinel)自动降级。

业务代码中只抛出语义明确的业务异常

杜绝在 service 层写 try-catch-log-rethrow,也避免把技术异常包装成业务异常(比如把 DB 连接失败说成“用户不存在”)。

  • 校验失败时直接 throw new OrderBizException(ORDER_STOCK_SHORTAGE, "库存不足,剩余{0}件", stock);前端根据 code 渲染对应提示。
  • 调用下游接口前先做前置校验(如参数合法性、状态一致性),校验失败走 BizException;调用失败则原样抛出或转为技术异常封装,交由全局处理器兜底。
  • 事务方法内慎用 try-catch 吞掉 BizException,否则 @Transactional 可能不回滚(需确保异常未被吞且是 RuntimeException 子类)。

基本上就这些。核心是让每种异常各司其职:业务异常讲人话、系统异常追根源、技术异常管依赖。体系建好了,排查省一半力,上线少一半火。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

779

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

722

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

727

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

394

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

398

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

443

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

428

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16840

2023.08.03

俄罗斯搜索引擎Yandex最新官方入口网址
俄罗斯搜索引擎Yandex最新官方入口网址

Yandex官方入口网址是https://yandex.com;用户可通过网页端直连或移动端浏览器直接访问,无需登录即可使用搜索、图片、新闻、地图等全部基础功能,并支持多语种检索与静态资源精准筛选。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1

2025.12.29

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 2.1万人学习

C# 教程
C# 教程

共94课时 | 5.5万人学习

Java 教程
Java 教程

共578课时 | 39.1万人学习

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

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号