Java自定义异常设计与实现方法
golang学习网今天将给大家带来《Java自定义异常信息设计指南》,感兴趣的朋友请继续看下去吧!以下内容将会涉及到等等知识点,如果你是正在学习文章或者已经是大佬级别了,都非常欢迎也希望大家都能给我建议评论哈~希望能帮助到大家!
应继承RuntimeException并定义带errorCode和context的异常基类, errorCode用枚举或常量,保留原始异常链,变量存context而非message,重写toString以输出关键信息。

Java里异常信息不是靠“拼字符串”临时凑出来的,而是要通过自定义异常类把错误码、业务上下文、原始异常链一起固化进去——否则日志里全是 "null pointer" 或 "illegal argument",根本看不出是“用户余额不足”还是“优惠券已过期”。
怎么让异常自带错误码和业务语义?
别再用 throw new RuntimeException("余额不足") 这种写法。它没法区分场景,前端也不能靠字符串匹配提示文案。正确做法是定义带 errorCode 字段的异常基类:
public abstract class BaseException extends RuntimeException {
private final String errorCode;
private final Map context = new HashMap<>();
protected BaseException(String errorCode, String message) {
super(message);
this.errorCode = errorCode;
}
protected BaseException(String errorCode, String message, Throwable cause) {
super(message, cause);
this.errorCode = errorCode;
}
public String getErrorCode() { return errorCode; }
public Map getContext() { return context; }
}
errorCode必须是枚举或常量(如USER_INSUFFICIENT_BALANCE),不能是硬编码字符串- 构造时传入
cause,才能保留原始异常堆栈,避免丢失关键线索 - 用
context存订单号、用户ID等现场数据,排查时直接可查,不用翻日志找关联字段
该继承 Exception 还是 RuntimeException?
绝大多数业务异常必须继承 RuntimeException。受检异常(extends Exception)在分层调用中会强制上层加 throws,导致 Service 层、Controller 层到处都是异常声明,严重污染接口契约。
- 只有极少数场景适用受检异常:比如调用银行支付 SDK 时,必须确保调用方显式处理“签名失败”这类不可忽略的集成错误
- Spring 全局异常处理器(
@RestControllerAdvice)只捕获RuntimeException及其子类,继承Exception的异常会被绕过 - 如果误用受检异常,你会看到 Controller 返回 500,但全局异常处理器压根没触发——因为 Spring 默认不拦截受检异常
异常消息里能不能拼接变量?
可以,但禁止在 message 字段里直接拼接敏感或动态值(如密码、token、完整 SQL)。正确做法是把变量放进 context,消息保持静态可读:
// ✅ 好:message 固定,变量走 context
throw new BusinessException("USER_LOGIN_FAILED", "登录失败")
.withContext("username", username)
.withContext("ip", request.getRemoteAddr());
// ❌ 坏:message 含变量,日志聚合失效、安全风险、i18n 难做
throw new BusinessException("USER_LOGIN_FAILED", "登录失败: 用户 " + username + " 从 " + ip + " 登录");
- 静态 message 方便 ELK 按模板聚合错误频次;动态拼接会导致每条日志 message 都不同,无法统计
context中的值可被日志框架自动脱敏(如屏蔽手机号中间四位),message 里的内容则无法控制- 国际化时,message 是 key,变量由前端或 i18n 工具注入,而不是后端硬拼
最常被忽略的一点:异常类本身要实现 toString() 或重载日志输出逻辑,否则打印异常时看不到 errorCode 和 context ——它们就只是藏在对象深处的摆设。
今天关于《Java自定义异常设计与实现方法》的内容介绍就到此结束,如果有什么疑问或者建议,可以在golang学习网公众号下多多回复交流;文中若有不正之处,也希望回复留言以告知!
Golang文本搜索工具实现教程
- 上一篇
- Golang文本搜索工具实现教程
- 下一篇
- 爱发电官网最新版功能全面升级
-
- 文章 · java教程 | 21小时前 |
- Java Formatter 怎样控制十六进制输出的宽度和补零
- 492浏览 收藏
-
- 文章 · java教程 | 21小时前 | 并发编程 · Java教程 · java 锁竞争 reentrantlock hasQueuedThreads 并发监控
- Java ReentrantLock.hasQueuedThreads 怎样判断是否有线程排队
- 490浏览 收藏
-
- 文章 · java教程 | 21小时前 | 文件读取 · Stream · Java教程 · java 大文件 Stream try-with-resources Files.lines UncheckedIOException
- Java Files.lines 怎样遍历大文件并确保流关闭
- 305浏览 收藏
-
- 文章 · java教程 | 21小时前 | Java教程 · Optional · java map optional predicate orElseThrow Optional.filter
- Java Optional.filter 按业务条件保留值的链式处理方案
- 234浏览 收藏
-
- 文章 · java教程 | 21小时前 | java Stream linkedhashmap Collectors groupingBy
- Java Stream 怎样按多个字段分组并保留顺序
- 360浏览 收藏
-
- 文章 · java教程 | 21小时前 | 正则表达式 · Java教程 · java 正则表达式 pattern 命名捕获组 Matcher.group
- Java Pattern 命名捕获组怎样按名称读取匹配结果
- 128浏览 收藏
-
- 文章 · java教程 | 21小时前 | unicode · java stringbuilder unicode reverse UTF-16 代理项
- Java StringBuilder.reverse 怎样避免 Unicode 代理项被拆开
- 331浏览 收藏
-
- 文章 · java教程 | 21小时前 | java SequencedCollection reversed 正向遍历 反向视图
- Java SequencedCollection 怎样从同一个集合获取正向和反向视图
- 380浏览 收藏
-
- 文章 · java教程 | 21小时前 |
- Java 模式匹配 switch 怎样处理 null 分支
- 487浏览 收藏
-
- 文章 · java教程 | 21小时前 | java 变量作用域 instanceof 类型收窄 record pattern 模式变量
- Java record pattern 与 instanceof 的变量作用域和类型收窄方法
- 310浏览 收藏
-
- 文章 · java教程 | 21小时前 | 虚拟线程 · java threadlocal 阻塞IO 虚拟线程 Virtual Thread
- Java 虚拟线程怎样判断阻塞调用是否适合迁移
- 133浏览 收藏
-
- 文章 · java教程 | 21小时前 |
- Java Collections.checkedList 怎样让错误类型尽早暴露
- 439浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1079次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1079次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1244次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1184次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1029次使用
-
- Java 时间格式兼容多个输入格式的方法
- 2026-10-18 501浏览
-
- Java try-with-resources 多个资源关闭顺序是什么
- 2026-09-10 501浏览
-
- 矩阵主副对角线快速定位技巧
- 2026-05-31 501浏览
-
- Java多态优化流程代码与行为分发改进
- 2026-05-26 501浏览
-
- JVM 类元数据双亲委派链表深度解析
- 2026-05-21 501浏览

