自定义异常可通过继承Exception类并添加错误码、时间戳等字段来携带上下文信息，提升错误定位效率。1. 定义BusinessException类包含errorCode和timestamp字段，并提供getter方法；2. 在业务逻辑中抛出该异常并传入具体信息；3. 调用方捕获异常后提取信息用于日志或响应；4. 可扩展构造函数或使用metadata map支持更多上下文。合理设计可增强系统可观测性与维护性。
在Java中，自定义异常（Custom Exception）不仅可以标识特定的错误类型，还能携带额外的上下文信息，帮助调用方更准确地定位问题。通过继承Exception类并添加自定义字段，可以实现信息传递。
1. 创建自定义异常类并添加额外字段
要让异常携带额外信息，可以在自定义异常类中定义私有字段，并提供getter方法访问这些数据。
例如，定义一个包含错误码和时间戳的异常：
public class BusinessException extends Exception {
private String errorCode;
private long timestamp;
public BusinessException(String message, String errorCode) {
super(message);
this.errorCode = errorCode;
this.timestamp = System.currentTimeMillis();
}
public String getErrorCode() {
return errorCode;
}
public long getTimestamp() {
return timestamp;
}
}
这样，抛出异常时就能附带错误码和发生时间。
立即学习“Java免费学习笔记（深入）”；
2. 抛出并传递详细信息
在业务逻辑中，根据具体场景抛出自定义异常：
public void processOrder(String orderId) throws BusinessException {
if (orderId == null || orderId.isEmpty()) {
throw new BusinessException("订单ID不能为空", "ORDER_001");
}
// 其他处理逻辑
}
3. 捕获异常并提取附加信息
调用方可以通过catch块捕获异常，并读取其中的额外信息用于日志记录或响应构造：
try {
processOrder("");
} catch (BusinessException e) {
System.out.println("错误信息: " + e.getMessage());
System.out.println("错误码: " + e.getErrorCode());
System.out.println("发生时间: " + e.getTimestamp());
}
这种方式适用于需要结构化错误处理的场景，比如Web API返回统一错误格式。
4. 可选：支持链式上下文信息
如果需要传递更多上下文，比如用户ID、操作类型等，可扩展构造函数：
public BusinessException(String message, String errorCode, String userId) {
super(message);
this.errorCode = errorCode;
this.timestamp = System.currentTimeMillis();
this.userId = userId;
}
或者使用Map存储动态属性：
private Map<String, Object> metadata = new HashMap<>();
public void addMetadata(String key, Object value) {
metadata.put(key, value);
}
public Object getMetadata(String key) {
return metadata.get(key);
}
基本上就这些。通过合理设计自定义异常的字段和构造方式，可以让异常成为信息传递的有效载体，提升系统的可观测性和维护效率。关键是要保持异常类的轻量和语义清晰，避免过度复杂化。
