0

0

什么是Java的业务异常与系统异常_自定义BizException的分层设计

P粉602998670

P粉602998670

发布时间:2026-03-14 10:29:04

|

798人浏览过

|

来源于php中文网

原创

BizException必须继承RuntimeException,因其属业务异常而非程序错误,需避免强制捕获污染代码;DAO层不得抛BizException,应由Service层根据返回结果判断业务规则并抛出。

什么是java的业务异常与系统异常_自定义bizexception的分层设计

Java里BizException该继承RuntimeException还是Exception

业务异常必须是 unchecked(不强制捕获),否则调用方会疯狂写 try-catch 或抛 throws,污染所有业务层代码。所以 BizException 必须继承 RuntimeException,不是 Exception

常见错误:有人为了“强制提醒处理”而继承 Exception,结果导致 Service 方法签名满屏 throws BizException,Controller 层被迫层层透传,最终和系统异常混在一起,全局异常处理器根本分不清哪是业务拒绝、哪是数据库挂了。

  • 继承 RuntimeException:符合“业务规则失败不属程序故障”的语义,也匹配 Spring 的 @ExceptionHandler 默认捕获策略
  • 别加 serialVersionUID:除非你真要跨 JVM 序列化它——业务异常不该被序列化传输
  • 构造函数只保留 String messageString message, Throwable cause 两个即可,避免过度设计

为什么不能在DAO层抛BizException

DAO 层只负责数据存取,它不知道“库存不足”是业务规则,它只看到 UPDATE product SET stock = stock - 1 WHERE id = ? AND stock >= 1 影响行数为 0。这个“影响行数为 0”应该由 Service 层判断后,再决定是否抛 BizException

典型翻车现场:DAO 方法里写 if (rows == 0) throw new BizException("库存扣减失败"),结果单元测试一跑就报错——因为 DAO 层不该持有业务语义,更不该触发全局异常拦截(比如被 @RestControllerAdvice 拦住返回 500,而不是 400)。

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

  • DAO 返回 int / boolean / Optional / 结果对象,让上层决定语义
  • Service 方法内做状态校验:if (product.getStock()
  • MyBatis 的 <select> 或 JPA 的 Optional<T> 查询不到时,也绝不直接抛业务异常

如何让BizException携带错误码和HTTP状态码

前端需要明确的 code(如 "ORDER_NOT_FOUND")和 HTTP 状态码(如 404),但 BizException 本身是 Java 异常,不能直接塞 HTTP 语义。正确做法是:异常类只管业务标识,状态码交给全局处理器映射。

Otter.ai
Otter.ai

一个自动的会议记录和笔记工具,会议内容生成和实时转录

下载

错误做法:在 BizException 里加 httpStatus 字段,然后全局处理器硬编码 switch;这样一旦新增异常类型就得改处理器,耦合死。

  • BizException 只含 code: Stringmessage: String(后者可走 i18n)
  • 定义枚举 BizCode,每个值对应一个 code 字符串和建议的 HTTP 状态码(如 ORDER_PAID(409)
  • 全局异常处理器中,根据 exception.getCode()BizCode.valueOf(code) 拿状态码,不依赖异常实例字段
  • 避免在异常构造时传入 HttpStatus.BAD_REQUEST —— 那会让异常和 Web 层绑定,无法复用于 RPC 或消息消费场景

全局异常处理器怎么区分BizException和其他异常

Spring 的 @RestControllerAdvice 默认按异常类型匹配,BizException 是你唯一的业务异常基类,所以处理器方法签名必须精准锁定它,而不是笼统捕获 Exception

容易忽略的坑:有人写一个 @ExceptionHandler(Exception.class) 处理所有异常,再在方法里用 instanceof 分支判断,结果 NullPointerExceptionIllegalArgumentException 全被当成业务异常返回 400,掩盖了真实 bug。

  • 显式声明 @ExceptionHandler(BizException.class),专治业务拒绝
  • 另配一个 @ExceptionHandler(RuntimeException.class) 捕获未预期的运行时异常,返回 500 并打 ERROR 日志
  • HttpMessageNotReadableException 这类 Spring 自带异常,单独写 handler 返回 400,别让它掉进通用 RuntimeException 分支
  • 确保 BizException 不被任何中间件(如 Sentinel、Dubbo)自动包装成其他异常类型,否则类型匹配失效

分层真正的难点不在代码怎么写,而在每次抛异常前,得想清楚:这是用户操作越界,还是系统某环崩了——前者归 BizException,后者连日志都要标 ERROR 级别。很多人卡在这一步,不是不会写,是没想明白语义边界。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

WorkBuddy
WorkBuddy

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

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

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

161

2025.08.06

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

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

89

2026.01.26

什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

184

2024.05.11

Golang 中间件开发与微服务架构
Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发,包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目,帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件,并在微服务环境中进行灵活部署与管理。

226

2025.12.18

mybatis一级缓存和二级缓存
mybatis一级缓存和二级缓存

在MyBatis中,一级缓存和二级缓存是两种不同级别的缓存机制,它们都可以用来提高性能。本专题提供mybatis一级缓存和二级缓存相关文章,大家可以免费阅读。

304

2023.08.21

ibatis和mybatis有什么区别
ibatis和mybatis有什么区别

ibatis和mybatis的区别:1、基本信息不同;2、开发时间不同;3、功能与易用性;4、配置文件;5、入参类型与出参类型;6、返回结果集接受方式;7、语法差异;8、数据库方言支持;9、插件支持;10、社区活跃度;11、全球化支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

94

2024.02.23

mybatis如何配置数据库连接
mybatis如何配置数据库连接

mybatis配置数据库连接的方法:1、指定数据源;2、配置事务管理器;3、配置类型处理器和映射器;4、使用环境元素;5、配置别名。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

106

2024.02.23

mybatis工作原理及流程是什么
mybatis工作原理及流程是什么

mybatis工作原理及流程:1、配置文件;2、接口与映射;3、sql解析与生成;4、执行计划;5、结果处理;6、动态sql;7、缓存机制;8、插件;9、事务管理;10、日志与监控;11、扩展性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

161

2024.02.23

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

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

26

2026.03.13

热门下载

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

精品课程

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

共23课时 | 4.4万人学习

C# 教程
C# 教程

共94课时 | 11.3万人学习

Java 教程
Java 教程

共578课时 | 81.5万人学习

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

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