Log4j2技术问询：Tomcat应用中如何为每条日志添加会话ID

当然可行啦！而且这在Log4j2里是非常容易落地的，你说的“为每条日志行创建回调”的思路，其实和Log4j2官方推荐的**MDC（映射诊断上下文）**方案不谋而合——本质就是在请求的生命周期回调里把会话ID注入到日志上下文，让日志模板可以直接引用它。

下面给你一步步拆解具体实现：

1. 核心思路：用Servlet Filter做请求回调 #

Tomcat里每个请求都会经过Filter链，我们可以写一个自定义Filter，在请求进来时获取会话ID并放入Log4j2的ThreadContext（也就是MDC的实现），请求结束后再清除这个上下文，避免线程池复用导致的信息污染。

2. 自定义Filter代码示例 #

import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
import org.apache.logging.log4j.ThreadContext;

public class SessionIdMdcFilter implements Filter {
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        // 初始化逻辑可选，比如读取配置，一般无需额外编写
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        try {
            // 判断是否为HTTP请求，获取会话ID（false表示不存在会话时不创建新会话）
            if (request instanceof HttpServletRequest) {
                HttpServletRequest httpRequest = (HttpServletRequest) request;
                if (httpRequest.getSession(false) != null) {
                    String sessionId = httpRequest.getSession(false).getId();
                    ThreadContext.put("SessionId", sessionId);
                }
            }
            // 继续执行后续请求逻辑
            chain.doFilter(request, response);
        } finally {
            // 必须在finally块移除，防止Tomcat线程池复用线程时携带错误的会话ID
            ThreadContext.remove("SessionId");
        }
    }

    @Override
    public void destroy() {
        // 销毁逻辑可选
    }
}

3. 在web.xml中配置Filter #

把自定义Filter注册到Tomcat的请求链中，确保所有请求都能经过它：

<filter>
    <filter-name>SessionIdMdcFilter</filter-name>
    <filter-class>com.your.package.SessionIdMdcFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>SessionIdMdcFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

4. 配置Log4j2的日志格式 #

在你的log4j2配置文件（比如log4j2.xml）里，修改PatternLayout，加入%X{SessionId}占位符，就能把会话ID按你期望的格式打印出来：

<Appenders>
    <Console name="Console" target="SYSTEM_OUT">
        <!-- 格式完全匹配你给出的示例 -->
        <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss,SSS} %level %X{SessionId} %c %msg%n"/>
    </Console>
    <!-- 日志文件Appender也可以用同样的格式配置 -->
    <File name="File" fileName="logs/app.log">
        <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss,SSS} %level %X{SessionId} %c %msg%n"/>
    </File>
</Appenders>

额外说明 #

如果你说的“回调”是指Log4j2本身的扩展点（比如自定义LogEvent或者Layout），其实也能实现，但MDC+Filter的方式是最简洁高效的，也是官方推荐的上下文信息注入方案，完全符合你“实用性较强”的需求。

这样配置完成后，每条和请求相关的日志都会自动带上对应的会话ID，完美匹配你想要的日志格式～

内容的提问来源于stack exchange，提问作者Vojtěch