Java 自定义异常中怎么区分用户错误和系统错误
在 java 中,区分用户错误(如参数校验失败)和系统错误(如数据库连接中断)的最佳实践是继承不同的父类:用户错误通常继承 runtimeexception 并标记为 unchecked,而系统错误则继承 exception 并标记为 checked。具体做法是定义两个基类,一个用于业务逻辑中的非法输入,另一个用于基础设施故障,并在代码中通过捕获范围来明确处理边界。

如何设计用户错误的基类
用户错误是指由调用方提供的无效数据或操作引起的异常,例如用户名已存在或密码格式错误。这类异常不需要强制捕获,因为它们是程序逻辑的一部分,可以通过前置校验避免。我们创建一个名为 UserInputException 的类,它直接继承自 RuntimeException,这样开发者在使用时可以选择性地捕获它,或者让它自然向上抛出。

public class UserInputException extends RuntimeException {
public UserInputException(String message) {
super(message);
}
public UserInputException(String message, Throwable cause) {
super(message, cause);
}
}
如何设计系统错误的基类
系统错误是指外部环境或基础设施导致的故障,例如网络连接超时、文件读取失败或数据库宕机。这类异常通常是不可预见的,且往往需要重试或降级处理,因此必须强制调用者进行捕获和处理。我们创建一个名为 SystemFailureException 的类,它继承自 Exception,从而成为受检异常(Checked Exception),迫使代码在编译期就考虑错误处理路径。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

public class SystemFailureException extends Exception {
public SystemFailureException(String message) {
super(message);
}
public SystemFailureException(String message, Throwable cause) {
super(message, cause);
}
}
在具体业务方法中如何混合使用这两种异常
在一个典型的业务方法中,我们可能需要同时处理用户输入验证和外部资源访问。例如,在保存用户信息时,先检查输入是否合法,再尝试写入数据库。如果输入不合法,抛出 UserInputException;如果数据库连接失败,抛出 SystemFailureException。这种混合使用方式清晰地划分了责任边界:调用方可以单独捕获 UserInputException 来提示前端修改表单,也可以单独捕获 SystemFailureException 来记录日志或触发告警。
public void saveUser(String username, String email) throws SystemFailureException {
if (username == null || username.isEmpty()) {
throw new UserInputException("Username cannot be empty");
}
if (!email.contains("@")) {
throw new UserInputException("Invalid email format");
}
// Simulate database operation that might fail
try {
// Database connection logic here
System.out.println("User saved successfully");
} catch (SQLException e) {
throw new SystemFailureException("Database error occurred", e);
}
}
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










