Java案例怎么实现异常通知？

wen java案例 2026-06-08 24

Java案例怎么实现异常通知？从捕获到告警的完整实践指南

目录导读

异常通知的核心价值：为什么你需要主动告警？
基础实现：try-catch + 邮件通知的简易方案
进阶方案：AOP切面统一拦截异常并通知
企业级实践：整合Spring、钉钉/企业微信与日志系统
常见问题解答（Q&A）

异常通知的核心价值：为什么你需要主动告警？

在Java应用中,异常是不可避免的，传统做法是在控制台打印堆栈或记录到日志文件，但这种方式存在致命缺陷：开发人员不会24小时盯着日志，一旦线上出现NullPointerException或数据库连接超时，业务可能中断数小时才发现。

Java案例怎么实现异常通知？

异常通知的目标是：当Java程序抛出特定异常时，自动通过邮件、短信、即时通讯（如钉钉、企业微信）或Webhook触发告警，让运维人员在分钟级内做出响应。

一个真相：根据Google SRE报告，80%的线上故障在发生后15分钟内无任何告警，而引入异常通知后，平均响应时间可缩短至3分钟以下。

基础实现：try-catch + 邮件通知的简易方案

最原始的方式是在每个业务逻辑的catch块中调用邮件发送方法。

代码示例：

public class EmailNotifier {
    public static void sendExceptionAlert(String subject, Exception e) {
        // 使用JavaMail或Spring MailSender
        SimpleMailMessage msg = new SimpleMailMessage();
        msg.setTo("admin@company.com");
        msg.setSubject(subject);
        msg.setText(ExceptionUtils.getStackTrace(e));
        mailSender.send(msg);
    }
}
// 业务代码中调用
try {
    orderService.placeOrder(request);
} catch (Exception e) {
    EmailNotifier.sendExceptionAlert("订单创建失败", e);
    throw e; // 继续抛出让上层处理
}

优点：直观、零框架依赖。
缺点：侵入性极强，每个方法都要重复写catch + 发送逻辑；无法统一控制告警频率（可能导致邮件轰炸）；不支持异步发送（会阻塞主线程）。

进阶方案：AOP切面统一拦截异常并通知

使用Spring AOP可以彻底解决代码侵入问题。

第一步：创建自定义注解

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface ExceptionNotify {
    String title() default "异常告警";
}

第二步：编写切面类

@Aspect
@Component
public class ExceptionNotifyAspect {
    @AfterThrowing(pointcut = "@annotation(exceptionNotify)", throwing = "ex")
    public void handleException(JoinPoint joinPoint, ExceptionNotify exceptionNotify, Exception ex) {
        String methodName = joinPoint.getSignature().toShortString();
        String className = joinPoint.getTarget().getClass().getName();
        String title = exceptionNotify.title();
        String content = String.format("【异常告警】类：%s；方法：%s；异常：%s",
                className, methodName, ex.getMessage());
        // 异步发送告警
        CompletableFuture.runAsync(() -> emailService.sendAlert(title, content));
    }
}

第三步：在业务方法上使用

@ExceptionNotify(title = "订单服务异常")
public Order createOrder(OrderRequest request) {
    // 业务逻辑，异常会被切面自动捕获并通知
}

优点：零侵入、集中管理、支持异步、可扩展。

企业级实践：整合Spring、钉钉/企业微信与日志系统

真实生产环境中,邮件可能被拦截或延迟，更常见的是使用钉钉机器人Webhook或企业微信机器人。

整合方案一：钉钉机器人通知

public class DingTalkNotifier {
    public static void sendText(String webhookUrl, String content) {
        Map<String, Object> requestBody = new HashMap<>();
        requestBody.put("msgtype", "text");
        requestBody.put("text", Map.of("content", content));
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);
        new RestTemplate().postForEntity(webhookUrl, 
                new HttpEntity<>(requestBody, headers), String.class);
    }
}

整合方案二：结合日志级别与告警阈值 在AOP切面中增加逻辑：