CustomException 抛出时如何触发告警
在 java 中,自定义异常通过继承 exception 或 runtimeexception 来定义,要实现及时通知,核心做法是在捕获该异常的代码块中集成消息发送逻辑。通常的做法是创建一个包含业务状态码和详细信息的自定义异常类,然后在服务层或全局异常处理器中捕获它,并调用第三方告警接口(如钉钉、企业微信或邮件 api)发送通知。这样做能确保当特定业务逻辑失败时,运维或开发人员能立即收到反馈,而不是仅仅看到日志堆栈。

实现这一机制需要两个主要部分:一个是携带告警数据的异常类,另一个是负责执行通知动作的工具类。以下是一个完整的示例程序,展示了如何定义异常并在捕获时触发模拟的告警通知。
import java.util.HashMap;
import java.util.Map;
// 1. 定义自定义异常,携带告警所需的信息
class OrderAlertException extends RuntimeException {
private final String orderId;
private final String alertLevel;
public OrderAlertException(String orderId, String alertLevel, String message) {
super(message);
this.orderId = orderId;
this.alertLevel = alertLevel;
}
public String getOrderId() { return orderId; }
public String getAlertLevel() { return alertLevel; }
}
// 2. 模拟告警通知服务
class AlertService {
public void sendNotification(String level, String orderId, String reason) {
// 实际场景中这里会调用 HTTP 客户端发送 POST 请求
System.out.println("[ALERT SENT] Level: " + level + ", Order: " + orderId + ", Reason: " + reason);
}
}
// 3. 业务处理类
class OrderProcessor {
private AlertService alertService = new AlertService();
public void processOrder(String orderId, int stock) {
if (stock < 0) {
// 抛出携带告警信息的异常
throw new OrderAlertException(orderId, "CRITICAL", "Stock is negative for order " + orderId);
}
System.out.println("Order processed successfully.");
}
// 4. 统一处理入口,负责捕获并触发告警
public void handleWithAlert(String orderId, int stock) {
try {
processOrder(orderId, stock);
} catch (OrderAlertException e) {
// 关键步骤:捕获后调用告警服务
alertService.sendNotification(e.getAlertLevel(), e.getOrderId(), e.getMessage());
// 可以选择重新抛出或记录日志
}
}
}
public class Main {
public static void main(String[] args) {
OrderProcessor processor = new OrderProcessor();
// 触发告警场景
processor.handleWithAlert("ORD-123", -5);
}
}运行上述代码,控制台将输出:
[ALERT SENT] Level: CRITICAL, Order: ORD-123, Reason: Stock is negative for order ORD-123
这验证了异常被正确捕获且告警逻辑已执行。
全局异常处理器中如何配置告警规则
在实际的企业级应用中,手动在每个方法里写 try-catch 并不现实,更常见的做法是使用 Spring Boot 的 @ControllerAdvice 或 @RestControllerAdvice 来构建全局异常处理器。通过在 @ExceptionHandler 注解中指定自定义异常类型,可以集中管理告警逻辑。这种方式的优点是解耦了业务代码与告警代码,且能统一处理所有未捕获的自定义异常。
立即学习“Java免费学习笔记(深入)”;

使用 Husky 将 pre-commit、pre-push 和 commit-msg 检查集成到仓库中,以便代理和开发人员在更改离开工作站之前运行相同的本地防护措施。
以下是基于 Spring Boot 的全局异常处理器示例,展示了如何配置告警规则。假设我们有一个统一的告警网关接口。
import org.springframework.web.bind.annotation.*;
import org.springframework.http.ResponseEntity;
import org.springframework.web.context.request.WebRequest;
@RestControllerAdvice
public class GlobalExceptionHandler {
// 注入告警服务
@Autowired
private AlertGateway alertGateway;
/**
* 专门处理 OrderAlertException
*/
@ExceptionHandler(OrderAlertException.class)
public ResponseEntity<String> handleOrderAlert(OrderAlertException ex, WebRequest request) {
// 1. 记录错误日志
System.err.println("Handling critical error: " + ex.getMessage());
// 2. 触发实时告警通知
// 根据异常中的等级决定发送渠道,例如 CRITICAL 发短信,WARNING 发邮件
if ("CRITICAL".equals(ex.getAlertLevel())) {
alertGateway.sendSms(ex.getOrderId(), ex.getMessage());
} else {
alertGateway.sendEmail(ex.getOrderId(), ex.getMessage());
}
// 3. 返回给前端的响应
return ResponseEntity.status(500).body("Order processing failed: " + ex.getMessage());
}
// 其他通用异常处理...
}在这个结构中,GlobalExceptionHandler 拦截了所有抛出的 OrderAlertException。开发者可以根据 getAlertLevel() 的值动态选择告警通道。例如,如果异常对象中的等级是 CRITICAL,则调用 sendSms;如果是 WARNING,则调用 sendEmail。这种配置确保了告警规则的灵活性和集中管理。
当异常信息中包含敏感数据时如何处理
在自定义异常中传递告警信息时,一个常见的问题是异常消息可能包含用户隐私或敏感业务数据(如身份证号、密码等)。如果在告警通知中直接打印或发送这些原始信息,会造成数据泄露风险。因此,需要在捕获异常后、发送告警前,对异常信息进行脱敏处理或过滤。
解决这个问题的具体做法是在 handleWithAlert 或全局异常处理器中,使用正则表达式或专门的脱敏工具类对 e.getMessage() 进行处理。例如,可以将手机号中间四位替换为星号,或者移除特定的敏感字段。此外,还可以设计一个专门的“告警摘要”字段,只包含必要的故障标识,而不包含完整堆栈或敏感详情。
import java.util.regex.Pattern;
public class SensitiveDataFilter {
private static final Pattern PHONE_PATTERN = Pattern.compile("(\d{3})\d{4}(\d{4})");
public static String maskSensitiveInfo(String message) {
if (message == null) return "";
// 简单示例:脱敏手机号
String masked = PHONE_PATTERN.matcher(message).replaceAll("$1****$2");
// 实际项目中可能需要移除更多敏感词或字段
return masked;
}
}
// 在异常处理中使用
try {
processOrder("ORD-456", -1);
} catch (OrderAlertException e) {
String safeMessage = SensitiveDataFilter.maskSensitiveInfo(e.getMessage());
alertService.sendNotification(e.getAlertLevel(), e.getOrderId(), safeMessage);
}通过这种方式,即使异常消息中包含 13812345678,发送给告警系统的也会是 138****5678,从而在保证故障可追溯的同时,符合数据安全合规要求。

















