<dependencies>
    <!-- Spring Boot Log4j2 Starter -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <exclusions>
            <!-- 排除掉默認(rèn)的 logback 依賴 -->
            <exclusion>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-logging</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-log4j2</artifactId>
    </dependency>
</dependencies>

import org.apache.logging.log4j.ThreadContext;
import org.springframework.stereotype.Component;
import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.UUID;

@Component
public class TraceIdFilter implements Filter {
    
    // 你可以自定義請求頭中TraceId的名字
    private static final String TRACE_ID_HEADER = "X-Trace-Id";
    // 這是TraceId在Log4j2 ThreadContext中存儲的key
    private static final String TRACE_ID_KEY = "traceId";

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        HttpServletResponse httpResponse = (HttpServletResponse) response;

        // 嘗試從請求頭中獲取TraceId，如果沒有則生成一個(gè)
        String traceId = httpRequest.getHeader(TRACE_ID_HEADER);
        if (traceId == null || traceId.isEmpty()) {
            // 生成唯一ID，這里使用UUID，你可以根據(jù)需要調(diào)整
            traceId = UUID.randomUUID().toString().replace("-", "").substring(0, 16);
        }

        // 將TraceId放入Log4j2的ThreadContext，這樣日志就能自動(dòng)打印了
        ThreadContext.put(TRACE_ID_KEY, traceId);
        // 可選：將TraceId設(shè)置到響應(yīng)頭，方便前端或下游服務(wù)追蹤
        httpResponse.setHeader(TRACE_ID_HEADER, traceId);

        try {
            chain.doFilter(request, response); // 繼續(xù)執(zhí)行請求鏈
        } finally {
            // 請求處理完畢，務(wù)必清理ThreadContext，避免內(nèi)存泄漏和數(shù)據(jù)污染
            ThreadContext.remove(TRACE_ID_KEY);
        }
    }
}

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
    <Appenders>
        <!-- 控制臺輸出配置 -->
        <Console name="Console" target="SYSTEM_OUT">
            <!-- 設(shè)置日志輸出格式 -->
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level [%X{traceId}] %logger{36} - %msg%n" />
        </Console>
    </Appenders>
    <Loggers>
        <Root level="info">
            <AppenderRef ref="Console" />
        </Root>
    </Loggers>
</Configuration>

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class DemoController {
    
    private static final Logger logger = LoggerFactory.getLogger(DemoController.class);
    
    @GetMapping("/test")
    public String testEndpoint() {
        logger.info("收到請求"); // 日志會自動(dòng)包含traceId
        // ... 你的業(yè)務(wù)邏輯
        return "請求完成";
    }
}

# application.properties 示例
logging.file.name=/var/log/your-app/application.log

# application.yml 示例
logging:
  file:
    name: /var/log/your-app/application.log

# application.properties 示例
logging.file.path=/var/log/your-app

<!-- logback-spring.xml 示例片段 -->
<configuration>
    <springProperty scope="context" name="LOG_HOME" source="logging.file.path" defaultValue="/tmp/logs"/>
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 使用在application.properties中設(shè)置的logging.file.path -->
        <file>${LOG_HOME}/spring.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 按天歸檔日志 -->
            <fileNamePattern>${LOG_HOME}/application.%d{yyyy-MM-dd}.log</fileNamePattern>
            <!-- 保留最多30天的日志歷史 -->
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    <!-- 其他配置... -->
</configuration>

java -jar your-app.jar --logging.file.name=/path/to/your/logfile.log

export LOGGING_FILE_NAME=/path/to/your/logfile.log
java -jar your-app.jar