java 自定义异常携带错误码和错误信息,最直接的做法是定义一个继承自 exception 或 runtimeexception 的类,在其中添加 private final string code; 字段,并通过构造函数接收该值。调用方在捕获异常后,通过调用 getcode() 方法即可获取具体的业务错误码,而 getmessage() 则返回人类可读的错误描述。

如何设计支持错误码的自定义异常类结构
要实现这一功能,需要创建一个自定义异常类,该类必须包含一个用于存储错误码的私有字段,并提供对应的 getter 方法。同时,为了保持与标准异常体系的一致性,建议提供至少两个构造函数:一个仅接受消息,另一个同时接受错误码和消息。这样可以在不同场景下灵活使用。

public class BusinessException extends RuntimeException {
private final String code;
public BusinessException(String message) {
super(message);
this.code = "UNKNOWN";
}
public BusinessException(String code, String message) {
super(message);
this.code = code;
}
public String getCode() {
return code;
}
}
上述代码定义了 BusinessException,它继承了 RuntimeException。当抛出异常时,可以传入如 "400" 作为错误码,"参数无效" 作为消息。在 catch 块中,可以通过 e.getCode() 获取 "400",通过 e.getMessage() 获取 "参数无效"。
如何在业务逻辑中抛出并捕获此类异常
在实际业务代码中,当检测到非法状态或违反业务规则时,应直接抛出带有错误码的自定义异常。调用方通过 try-catch 结构捕获该异常,并根据错误码进行不同的处理逻辑,例如记录日志、返回特定的 HTTP 状态码或前端提示。

public class UserService {
public void register(String username) {
if (username == null || username.isEmpty()) {
throw new BusinessException("USER_001", "用户名不能为空");
}
// 其他注册逻辑
}
}
// 调用示例
try {
userService.register("");
} catch (BusinessException e) {
System.out.println("Error Code: " + e.getCode());
System.out.println("Error Msg: " + e.getMessage());
}
运行上述代码,控制台将输出:
Error Code: USER_001
Error Msg: 用户名不能为空
这验证了错误码和信息均能正确传递。若未指定错误码,默认值为 "UNKNOWN"。
如果只调用无参构造函数会返回什么错误码
如果只调用无参构造函数(即只传消息),由于代码中默认将 code 赋值为 "UNKNOWN",因此 getCode() 将返回 "UNKNOWN"。这意味着开发者必须显式调用双参构造函数才能携带有意义的业务错误码,否则无法区分具体错误类型。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











