当前位置：首页 > 文章列表 > 文章 > java教程 > Logback记录非200响应日志方法

Logback记录非200响应日志方法

2025-09-04 14:09:39 0浏览收藏

还在为难以追踪的非200 HTTP响应而烦恼吗？本文将提供一份详尽的Logback配置指南，教你如何高效记录这类异常响应。通过巧妙地运用Logback的过滤器和appender，我们可以将请求方法、路径及响应状态码等关键信息，精准地输出到独立的日志文件中，从而实现问题快速定位与诊断。文章将深入讲解如何自定义过滤器，利用MDC（Mapped Diagnostic Context）传递HTTP响应状态码，以及配置logback-spring.xml文件，确保只有非200响应的详细信息才会被记录。掌握这项技能，将显著提升你的问题排查效率，保障应用程序的稳定运行。

基于Logback配置实现非200 HTTP响应的详细日志记录

本文将介绍如何配置Logback，使得当控制器返回非200 HTTP响应时，能够将请求方法、路径和响应状态码等信息记录到单独的日志文件中。这种方式可以帮助开发者更有效地诊断和解决问题，而不会影响正常的日志输出。

方案概述

核心思路是利用Logback的过滤器和appender，根据HTTP响应的状态码来判断是否需要记录详细信息。具体来说，我们可以创建一个过滤器，只允许非200响应的日志通过，然后将这些日志输出到特定的appender，该appender负责将信息写入单独的日志文件。

具体步骤

定义一个过滤器 (Filter)

Logback允许我们自定义过滤器，根据特定的条件来决定是否允许日志事件通过。在这里，我们可以创建一个过滤器，检查HTTP响应的状态码是否为200。如果不是200，则允许日志通过；否则，拒绝日志。

虽然直接在logback-spring.xml中创建自定义过滤器可能比较复杂，但我们可以通过在代码中设置MDC（Mapped Diagnostic Context）来实现类似的效果。在处理HTTP请求的拦截器或过滤器中，记录响应状态码到MDC。

import org.slf4j.MDC;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class ResponseStatusInterceptor implements HandlerInterceptor {

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        MDC.put("responseStatus", String.valueOf(response.getStatus()));
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        // 在渲染视图之后清除MDC
        MDC.remove("responseStatus");
    }
}

配置Spring MVC拦截器：

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new ResponseStatusInterceptor());
    }
}

配置Logback (logback-spring.xml)

修改logback-spring.xml文件，添加一个appender，专门用于记录非200 HTTP响应的详细信息。这个appender应该配置一个过滤器，只允许MDC中responseStatus值不为200的日志通过。

<configuration>

    <appender name="ERROR_FILE" class="ch.qos.logback.core.FileAppender">
        <file>error.log</file>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
        <filter class="ch.qos.logback.core.filter.EvaluatorFilter">
            <evaluator>
                <expression>return !MDC.get("responseStatus").equals("200");</expression>
                <name>statusCheck</name>
            </evaluator>
            <OnMismatch>NEUTRAL</OnMismatch>
            <OnMatch>ACCEPT</OnMatch>
        </filter>
    </appender>

    <logger name="your.controller.package" level="ERROR" additivity="false">
        <appender-ref ref="ERROR_FILE"/>
    </logger>

    <root level="INFO">
        <appender-ref ref="CONSOLE"/>
        <appender-ref ref="FILE"/>
    </root>

</configuration>

ERROR_FILE appender: 定义了一个名为ERROR_FILE的appender，用于将错误信息写入error.log文件。
EvaluatorFilter: 使用EvaluatorFilter和Groovy表达式来判断MDC中responseStatus的值是否为"200"。如果不是"200"，则允许日志通过。
logger: 配置了一个logger，指定了需要记录的包名（your.controller.package），并将日志级别设置为ERROR。additivity="false" 表示该logger不会将日志传递给root logger。
root: 配置了root logger，用于处理其他级别的日志，并将日志输出到控制台和文件。

记录详细信息

在控制器中，当检测到非200响应时，记录包含请求方法、路径和响应状态码的详细信息。

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.http.HttpServletRequest;

@RestController
public class ProductController {

    private static final Logger logger = LoggerFactory.getLogger(ProductController.class);

    @GetMapping("/product/{id}")
    public ResponseEntity<String> getProduct(@PathVariable("id") int id, HttpServletRequest request) {
        if (id <= 0) {
            String message = String.format("Product with id %d not found", id);
            logger.error("method: {}, path: {}, response: {}", request.getMethod(), request.getRequestURI(), HttpStatus.NOT_FOUND.value());
            return new ResponseEntity<>(message, HttpStatus.NOT_FOUND);
        }

        return new ResponseEntity<>("Product found", HttpStatus.OK);
    }
}