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 拦截所有未被捕获的异常,按类型差异化处理:

AssemblyAI
AssemblyAI

转录和理解语音的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 子类)。

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1051

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

254

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1109

2024.03.01

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

492

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

382

2023.10.25

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

1961

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

658

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2403

2025.12.29

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

49

2026.03.13

热门下载

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

精品课程

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

共23课时 | 4.4万人学习

C# 教程
C# 教程

共94课时 | 11.3万人学习

Java 教程
Java 教程

共578课时 | 82.2万人学习

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

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