怎么自定义一个简单的 Java 异常类并手动 throw

哈喽！今天心血来潮给大家带来了《怎么自定义一个简单的 Java 异常类并手动 throw》，想必大家应该对文章都不陌生吧，那么阅读本文就都不会很困难，以下内容主要涉及到，若是你正在学习文章，千万别错过这篇文章~希望能帮助到你！

需继承Exception或RuntimeException，因所有异常必须是Throwable子类，且编译器强制要求；前者用于必须处理的检查型异常（如IO失败），后者用于无需强制处理的非检查型异常（如业务校验失败）。

为什么需要继承 Exception 或 RuntimeException

Java 中所有异常都必须是 Throwable 的子类，而实际开发中你几乎只会继承 Exception（检查型异常）或 RuntimeException（非检查型异常）。不继承它们，编译器会直接报错：unreported exception XXX; must be caught or declared to be thrown。

选择哪个父类取决于是否强制调用方处理：比如业务校验失败（如用户名为空），通常用 RuntimeException 子类，避免到处写 try-catch；而像文件读取失败这种外部依赖问题，更适合 Exception 子类。

最简自定义异常类怎么写

一个能用的最小实现只需要两行：一个空构造函数 + 一个带 String 参数的构造函数。Java 异常机制依赖这两个构造器把消息传给父类。

public class UserNotFoundException extends RuntimeException {
    public UserNotFoundException() {
        super();
    }
    public UserNotFoundException(String message) {
        super(message);
    }
}

注意：不需要重写 toString() 或手动拼接堆栈——父类已做好。也不建议加额外字段（如错误码），除非真有多个地方要读取它且逻辑统一。

throw 时常见错误和写法差异

手动 throw 一个自定义异常，和 throw NullPointerException 没本质区别，但容易踩几个坑：

• 忘记 new：写成 throw UserNotFoundException; 会编译失败，必须是 throw new UserNotFoundException("xxx");
• 消息写死又冗余：比如在 service 层抛出 new UserNotFoundException("用户不存在")，但调用方其实更想知道是哪个 ID 导致的——应该写成 new UserNotFoundException("user id: " + userId + " not found")
• 混用父类类型：如果定义的是 Exception 子类，但方法没声明 throws，编译就过不去；而 RuntimeException 子类可以随时 throw，无约束

什么时候该加构造器传 Throwable cause

只有当你想保留原始异常上下文时才需要。比如 DAO 层捕获了 SQLException，又想包装成业务异常向上抛，就得用带 cause 的构造器：

catch (SQLException e) {
    throw new DataAccessException("查询用户失败", e);
}

否则，原始异常的堆栈就丢了，排查时只能看到“查询用户失败”，看不到底层是连接超时还是 SQL 语法错。这个构造器不是必须的，但一旦涉及异常转译，漏掉它会让日志失去关键线索。

真正难的不是写这个类，而是判断该不该让异常逃出当前方法、该不该包装、该不该记录日志——这些没法靠继承搞定。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《怎么自定义一个简单的 Java 异常类并手动 throw》文章吧，也可关注golang学习网公众号了解相关技术文章。