java过滤重复异常堆栈日志的核心是避免重复打印，而非拦截日志：通过异常哈希值或堆栈指纹去重，结合weakreference/concurrenthashmap缓存、logback自定义filter、业务层统一记录及mdc透传唯一id实现精准去重。

Java 中过滤重复的异常堆栈日志，核心思路不是“拦截日志”，而是“避免重复打印”——即在业务逻辑或日志框架层面识别相同异常（尤其是同一异常实例、相同堆栈轨迹），跳过后续冗余输出。这需要结合异常特征判断 + 日志框架能力，而非简单配置过滤器。

基于异常对象哈希值去重（适用于同一异常被多次 catch/log）

同一个 Throwable 实例多次调用 logger.error("msg", e) 时，堆栈完全一致。可借助 WeakReference 缓存最近 N 个异常的哈希值（如 e.hashCode() 或 Arrays.hashCode(e.getStackTrace())），在日志 AOP 或自定义 Appender 中判断是否已记录过。

• 用 ConcurrentHashMap 存储 hashCode → timestamp，设置 TTL（如 5 分钟），防止内存泄漏
• 注意：hashCode() 不保证跨 JVM 唯一，但对单次运行内同一异常足够可靠；更稳妥可用 System.identityHashCode(e)
• 示例场景：全局异常处理器中反复调用 log.error(..., ex)，可在包装方法里先查缓存再决定是否打印

基于堆栈指纹（stack trace fingerprint）去重（适用不同实例但相同错误）

不同时间抛出的 NullPointerException 可能堆栈行号略有差异（如因代码微调），需归一化处理后比对。提取关键信息生成“指纹”：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 取前 5–10 行非 JDK/框架包的栈帧（过滤 java.*、sun.*、org.slf4j.* 等）
• 标准化类名、方法名、文件名（去掉行号、泛型、lambda 标识等）
• 对归一化后的字符串做 MD5 或 xxHash，用摘要值作为指纹 key 缓存
• Logback 可通过自定义 Filter（继承 ch.qos.logback.core.filter.Filter）在 decide() 中实现该逻辑

利用日志框架原生能力（Logback / Log4j2）

不推荐纯靠配置，但可辅助降噪：

• Logback：使用 ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy 配合压缩归档，虽不防重复，但便于后续用脚本（如 awk/grep）聚合分析
• Log4j2：启用 AsyncLogger + DiscardingThreshold 可丢弃低优先级重复日志，但不精准匹配堆栈；更实用的是配合 ScriptFilter 调用 Groovy 判断堆栈相似度
• 二者都支持 MDC，可在捕获异常时写入 MDC.put("exc_fingerprint", fingerprint)，再用 PatternLayout 输出，方便 ELK 中聚合去重

业务层主动控制（最直接有效）

多数重复日志源于设计问题，比如：

• Controller 层捕获异常 → Service 层又捕获同一异常 → 多处 log.error
• 重试机制中每次失败都打全量堆栈
• 解决方案：只在最外层（如统一异常处理器）记录完整堆栈；内部模块改用 warn/info 级别 + 关键上下文（如 “重试第 2 次失败，原因见主日志 ID: abc123”）
• 为异常添加唯一 ID（如 UUID），通过 MDC 透传，所有相关日志带该 ID，便于追踪和聚合，而非盲目去重

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南