通过ThreadLocal和HandlerInterceptor实现java后台业务埋点日志功能

本文链接：https://blog.youkuaiyun.com/liufeixiaowei/article/details/78685350

文章介绍了如何通过ThreadLocal存储自定义的日志实体，并利用HandlerInterceptor在Spring MVC中进行请求的前置和后置处理，以此替代不便管理的MDC（Mapped Diagnostic Context），实现更方便的后台业务埋点日志功能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

目前公司的方案是用mdc来实现一个请求的业务数据埋点记录，但是mdc是map方式，需要手动设置key，而且每次都要手动clear，一是不方便管理，再者如果忘记clear会造成业务埋点数据混乱。所以有了想要把埋点数据字段统一封装的想法，这样方便维护，后面如果修改，也很容易找到所有修改点。于是我就想把封装好的bean放到mdc里，然后再用切面统一处理，但是，研究发现，mdc的value不支持object只能用String，很失望。我顺手翻了一下mdc的源码，如下

MDC的put方法源码
private InheritableThreadLocal<Map<String, String>> inheritableThreadLocal = new InheritableThreadLocal<Map<String, String>>() {
    protected Map<String, String> childValue(Map<String, String> parentValue) {
      return parentValue == null?null:new HashMap(parentValue);
    }
  };

  public BasicMDCAdapter() {
  }

  public void put(String key, String val) {
    if(key == null) {
      throw new IllegalArgumentException("key cannot be null");
    } else {
      Map<String, String> map = (Map)this.inheritableThreadLocal.get();
      if(map == null) {
        map = new HashMap();
        this.inheritableThreadLocal.set(map);
      }

      ((Map)map).put(key, val);
    }
  }

发现是用ThreadLocal实现的，它直接把里面的对象定义成map，我想，那我是不是可以定义成我自己的日志实体，开始动手，写了一个简单的类，如下

public class BusinessLogUtil {

  private final static ThreadLocal<BusinessLog> threadLocal = new InheritableThreadLocal<>();

  public static BusinessLog getThreadLocalLog() {
    if (threadLocal.