瞧瞧别人家的日志，那叫一个优雅！

作者：苏三2026-01-11

前言

最近缺项目经历想快速提升项目实战能力（包含多个AI项目），或者最近找工作，或者想学习AI的小伙伴，可以看看下面👇🏻的这个链接（或许真的能够帮到你）。

上周排查线上问题时，看到了这样的日志片段：

[ERROR] 用户 {} 登录失败  
[INFO] 订单创建成功 id=  
DEBUG 库存扣减异常 - null

看着这些缺胳膊少腿的日志，我仿佛听见服务器在嘲笑："你们程序员连日志都写不整齐？"

诊断报告：

pie  
    title 日志问题分布  
    "缺少关键参数" : 38  
    "级别错用" : 25  
    "格式混乱" : 22  
    "过度打印" : 15

二、优雅日志的三大军规

2.1 规范化的仪式感

坏味道代码：

log.info("用户登录");

有价值的信息比较少。

优雅改造：

// 使用SLF4J占位符  
log.info("用户登录成功, username:{}, clientIP:{}", username, clientIP);  

// 结构化日志  
logger.log(LogEntry.builder()  
    .event("USER_LOGIN")  
    .param("username", username)  
    .param("clientIP", clientIP)  
    .build());

改造后的流程图如下：

2.2 智能分级策略

反例警示：

try {  
    // 业务代码  
} catch (Exception e) {  
    log.error("出错了"); // 没有堆栈  
}

代码出现异常时，日志中没有记录堆栈信息，自己吃了异常。。。

改造后的优雅方案：

// Logback配置示例  
<turboFilter class="ch.qos.logback.classic.turbo.DynamicThresholdFilter">  
    <MDCKey>LOG_LEVEL</MDCKey>  
    <DefaultThreshold>INFO</DefaultThreshold>  
</turboFilter>  

// 动态调整日志级别  
MDC.put("LOG_LEVEL", "DEBUG");

日志级别决策树：

2.3 追踪的艺术（TraceID全景追踪）

为了方便我们进行全局追踪日志，特别是在微服务中，需要增加TraceID。

具体代码如下：

// 拦截器注入TraceID  
public class TraceInterceptor extends HandlerInterceptorAdapter {  
    @Override  
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {  
        MDC.put("traceId", UUID.randomUUID().toString().replace("-",""));  
    }  
}  

// 日志格式  
%d{yyyy-MM-dd HH:mm:ss} [%X{traceId}] %-5level %logger{36} - %msg%n

调用链可视化追踪日志图：

三、高级玩家必备的四大神技

3.1 日志瘦身大法

问题场景：

log.debug("开始处理用户数据, user:{}, items:{}", user, itemList); // 打印超大对象

上面的问题是打印了整个itemList，它是一个超大的对象。

可能会导致日志文件过大。

解决方案：

// 自定义toString()  
@Override  
public String toString() {  
    return "User{" +  
        "id=" + id +  
        ", nameMask='" + StringUtils.mask(name) + "'}";  
}  

// 日志过滤器  
public class SensitiveFilter extends Filter<ILoggingEvent> {  
    @Override  
    public FilterReply decide(ILoggingEvent event) {  
        return event.getMessage().contains("password") ? FilterReply.DENY : FilterReply.ACCEPT;  
    }  
}


### 3.2 智能采样策略
**日志配置**：

```java
<!-- 按比例采样 -->  
<appender name="SAMPLING" class="ch.qos.logback.classic.sift.SiftingAppender">  
    <discriminator class="com.example.RateSampler"/>  
</appender>

采样算法：

graph TD  
    A[请求进入] --> B{随机数<采样率?}  
    B -->|是| C[记录详细日志]  
    B -->|否| D[仅记录摘要]

3.3 立体化监控

ELK架构图：

报警规则示例：

ERROR级别日志 > 100次/分钟 触发电话报警  
WARN级别日志持续5分钟 触发企业微信通知

3.4 混沌工程演练

日志健壮性测试用例：

@Test  
public void testLogOverflow() {  
    // 模拟日志洪峰  
    IntStream.range(0, 100000).forEach(i ->  
        log.info("压力测试日志:{}", i)  
    );  
    assertTrue(日志文件未丢失);  
}

四、从青铜到王者的进化路线

journey  
    title 日志优化段位进化史  
    section 青铜  
        硬编码日志  
        随意打印  
    section 白银  
        统一格式  
        基础过滤  
    section 黄金  
        全链路追踪  
        结构化日志  
    section 钻石  
        智能采样  
        动态分级  
    section 王者  
        预测性分析  
        自愈式日志

五、血的教训：这些坑我替你踩过了

日志风暴：某次大促因DEBUG日志未关闭，直接打满磁盘
敏感泄露：打印完整用户对象导致密码泄露
追踪断裂：异步线程未传递TraceID导致链路断裂
报警疲劳：错误配置WARN级别报警导致半夜被叫醒5次