Java异常日志优化核心是“精准留痕”:提取根因、裁剪堆栈、结构化字段、自动脱敏、分级控制。用工具类获取root cause,正则截取关键堆栈行,MDC注入上下文,限制消息长度,正则过滤敏感信息,按日志级别动态控制堆栈输出。

Java异常日志里堆栈太长、重复字段多、敏感信息泄露,是线上排查效率低的常见原因。核心思路不是“全量打印”,而是“精准留痕”——保留定位问题必需的信息,过滤掉干扰项。
只打印关键异常层级
默认的printStackTrace()或logger.error("msg", e)会输出完整嵌套异常链,但多数时候只有最外层异常和根本原因(root cause)有用。建议用工具类提取关键层:
- 用
ThrowableUtils.getRootCause(e)(Apache Commons Lang)拿到最底层异常 - 用
ExceptionUtils.getStackTrace(e)配合正则截取前10行+最后5行,跳过中间冗余的框架调用(如Spring AOP、CGLIB代理层) - 自定义
PatternLayout或Logback的ThrowableProxyConverter,过滤掉org.springframework.cglib、com.sun.proxy等无关包名
结构化日志 + 字段裁剪
避免把整个Exception对象toString后塞进message字段。改用结构化方式记录:
- 用
MDC注入请求ID、用户ID、接口名等上下文,不混在异常消息里 - 日志模板中显式指定字段:
logger.error("order_submit_fail|code={},msg={},traceId={}", e.getErrorCode(), e.getMessage(), MDC.get("traceId")) - 对
e.getMessage()做长度限制(如StringUtils.substring(e.getMessage(), 0, 200)),防超长字符串刷屏
自动脱敏敏感内容
异常消息或堆栈里可能含手机号、身份证、token等。不能靠人工检查,要前置拦截:
立即学习“Java免费学习笔记(深入)”;
- 在日志Appender前加一个
Filter(Logback支持JaninoEventFilter),用正则匹配并替换"1[3-9]\\d{9}"、"\\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Z|a-z]{2,}\\b"等模式 - 对
SQLException特殊处理:提取SQLState和错误码,丢弃原始SQL语句(尤其含参数值的) - 重写
toString()的自定义异常类,确保getMessage()不拼接敏感字段
分级控制堆栈深度
不是所有异常都要打堆栈。按场景动态开关:
- ERROR级异常:默认输出根因+顶层异常+关键3层堆栈
- WARN级异常(如重试失败、降级触发):只打异常类名+消息,不打堆栈
- 测试/本地环境:可开全量;生产环境通过JVM参数
-Dlog.stack.depth=5统一控制
基本上就这些。关键是把日志当“诊断线索”来设计,而不是“异常快照”来保存。










