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

在Java中如何自定义异常类_JavaException扩展解析

雨明吖_1244

雨明吖_1244

发布时间:2026-01-20 12:22:02

|

925人浏览过

|

来源于php中文网

原创

必须继承Exception或RuntimeException,因JVM仅识别Throwable子类异常;继承Exception强制调用方处理,适合业务可控错误;继承RuntimeException则无需声明,适用于程序逻辑错误。

在java中如何自定义异常类_javaexception扩展解析

为什么必须继承 Exception 或 RuntimeException

Java 的异常体系强制要求自定义异常类必须是 Throwable 的子类,而实际开发中几乎总是选择继承 Exception(受检异常)或 RuntimeException(非受检异常)。不这样做会导致编译失败——比如直接继承 Object 写个 MyException,连 throw new MyException() 都过不了编译。

关键区别在于:继承 Exception 会让调用方**必须处理**(try/catch 或 throws),适合业务中明确需要强制干预的错误(如支付金额超限、用户未实名);继承 RuntimeException 则无需强制声明,适合程序逻辑错误或不可恢复的意外(如参数为 null 且不该发生)。

  • 不要试图绕过继承机制,用包装或代理方式模拟异常行为——JVM 不认,catch 不会捕获
  • 如果想让异常既可检查又可运行时切换,得靠两个独立类,不能靠“动态继承”
  • IDE 自动生成的构造函数常漏掉 cause 参数,导致嵌套异常信息丢失

super(message) 和 super(message, cause) 怎么选

绝大多数自定义异常类至少要提供带 String 参数的构造方法,否则 new MyBusinessException("余额不足") 会报错。但仅此不够——当你的异常是由另一个异常触发的(比如数据库操作失败引发业务异常),必须把原始异常作为 cause 传进去,否则堆栈里看不到底层根因。

推荐构造函数组合:

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

redis-tools
redis-tools

按类别查找Redis命令、检测服务器连接、监控键数量和内存占用,支持离线速查表。

下载
  • public MyException(String message) → 调用 super(message)
  • public MyException(String message, Throwable cause) → 调用 super(message, cause)
  • 可选:public MyException(Throwable cause) → 调用 super(cause),方便包装已有异常
public class InsufficientBalanceException extends Exception {
    public InsufficientBalanceException(String message) {
        super(message);
    }
    public InsufficientBalanceException(String message, Throwable cause) {
        super(message, cause);
    }
}

要不要重写 getMessage() 或 toString()

一般不用。父类 Exception 已经实现了清晰的 getMessage()(返回构造时传入的 message)和 toString()(含类名 + message)。除非你有强定制需求,比如所有业务异常必须前置固定前缀,才考虑重写:

public class OrderException extends Exception {
    public OrderException(String message) {
        super("[订单系统] " + message);
    }
    // 不建议重写 getMessage() 去拼接,容易和 cause.getMessage() 混淆
}

更安全的做法是:在日志打印时统一加前缀,而不是污染异常对象本身。重写 toString() 尤其危险——很多监控系统、序列化工具依赖它的默认格式,改了可能导致告警解析失败。

  • 日志框架(如 Logback)可通过 %X{traceId} 等 MDC 字段补充上下文,比改异常更灵活
  • 如果真要丰富异常信息,优先用额外字段 + getter(如 getOrderId()),而不是覆盖核心方法

序列化问题:serialVersionUID 必须显式声明吗

必须。自定义异常类默认实现 Serializable,一旦涉及远程调用(Dubbo、RMI)、缓存(Redis 存异常对象)、或集群间传递,没有显式 serialVersionUID 会导致 InvalidClassException:「local class incompatible」。

原因:JVM 自动生成的 UID 依赖类结构细节(方法签名、字段顺序等),微小改动就会变,而异常类常随业务迭代频繁修改字段(比如加个 errorCode int 字段)。

  • 固定值推荐用 1L 或时间戳(如 20240501L),避免用 IDE 自动生成的长随机数
  • 如果异常类确定永不序列化(如纯内存校验异常),可加 private static final long serialVersionUID = 0L; 并注释说明
  • 子类必须声明自己的 serialVersionUID,不会继承父类的
public class PaymentRejectedException extends RuntimeException {
    private static final long serialVersionUID = 20240501L;
    private final String transactionId;

    public PaymentRejectedException(String message, String transactionId) {
        super(message);
        this.transactionId = transactionId;
    }

    public String getTransactionId() {
        return transactionId;
    }
}
实际项目中最容易被忽略的是 cause 的透传和 serialVersionUID 的维护——前者让问题排查断链,后者让上线后出现莫名其妙的反序列化失败。

热门AI工具

更多
DeepSeek

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

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

豆包大模型

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

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

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

WorkBuddy

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

相关专题

更多
dubbo和zookeeper有什么区别
dubbo和zookeeper有什么区别

dubbo和zookeeper的区别:1、功能定位;2、使用场景;3、数据存储与协调;4、集成与关系;5、性能与可靠性;6、扩展性与灵活性;7、社区与生态系统。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

636

2024.02.23

springcloud和dubbo有哪些区别
springcloud和dubbo有哪些区别

springcloud和dubbo的区别:1、定位与关注点;2、生态环境与集成性;3、调用方式与性能;4、组件与功能;5、定制性与灵活性;6、学习曲线与上手难度;7、社区支持与维护。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

276

2024.02.23

dubbo原理和机制是什么
dubbo原理和机制是什么

dubbo原理和机制的解释:1、核心组件;2、通信原理;3、集群容错;4、自动发现与注册;5、负载均衡与路由;6、序列化与传输;7、监控与日志;8、扩展性;9、安全性;10、与spring集成等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

181

2024.02.23

string转int
string转int

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

6459

2023.08.02

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

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

549

2023.09.22

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

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

1698

2024.03.01

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

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

549

2023.09.22

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

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

1698

2024.03.01

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

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

精品课程

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