本文旨在提供一种在Spring Boot应用中优雅地记录HTTP请求体的方法，特别是在使用`@RequestBody`注解进行请求体自动反序列化时。通过集成Spring框架提供的`CommonsRequestLoggingFilter`，开发者可以实现对进入应用的HTTP请求的详细日志记录，包括查询字符串和请求载荷，而无需修改控制器方法的签名，从而保持代码的整洁和业务逻辑的专注。
在Spring Boot开发中，我们经常使用@RequestBody注解将HTTP请求体自动映射到Java对象。然而，在调试或集成第三方服务时，有时需要查看原始的HTTP请求体内容，以验证数据格式或排查反序列化问题。直接在控制器方法中通过HttpServletRequest读取请求体虽然可行，但会导致代码冗余，并且与@RequestBody的使用方式产生冲突，每次切换都需要修改方法签名。为了解决这一问题，Spring框架提供了CommonsRequestLoggingFilter，一个强大且灵活的解决方案，可以在不影响业务逻辑的前提下，实现请求体的统一日志记录。
使用 CommonsRequestLoggingFilter 记录请求体
CommonsRequestLoggingFilter是Spring Web提供的一个通用请求日志过滤器，它可以在请求到达控制器之前，对请求信息进行拦截并记录。通过简单的配置，我们就能使其记录包括请求体在内的详细信息。
1. 配置日志过滤器 Bean
要启用CommonsRequestLoggingFilter，我们需要在Spring Boot应用中定义一个配置类，并声明一个CommonsRequestLoggingFilter的Bean。这个Bean将负责设置过滤器的行为，例如是否包含查询字符串、请求载荷、最大载荷长度以及日志的前缀等。
以下是一个配置示例：
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.filter.CommonsRequestLoggingFilter;
@Configuration
public class RequestLoggingFilterConfig {
@Bean
public CommonsRequestLoggingFilter logFilter() {
CommonsRequestLoggingFilter filter = new CommonsRequestLoggingFilter();
// 设置是否包含请求的查询字符串
filter.setIncludeQueryString(true);
// 设置是否包含请求的载荷（即请求体）
filter.setIncludePayload(true);
// 设置最大载荷长度，超过此长度的载荷将被截断。这有助于防止日志文件过大。
filter.setMaxPayloadLength(10000); // 例如，最大记录10KB的请求体
// 设置是否包含请求头。根据需求选择是否开启。
filter.setIncludeHeaders(false);
// 设置日志消息的前缀，方便识别。
filter.setAfterMessagePrefix("REQUEST DATA : ");
return filter;
}
}在上述配置中：
- setIncludeQueryString(true)：确保日志中包含URL的查询参数。
- setIncludePayload(true)：这是关键，它指示过滤器记录HTTP请求的实际载荷（请求体）。
- setMaxPayloadLength(10000)：限制了记录请求体的最大长度。对于大型请求体，此设置可以防止日志文件变得过于庞大，同时避免潜在的性能问题。根据实际需求调整此值。
- setIncludeHeaders(false)：默认设置为不包含请求头。如果需要记录请求头，可以将其设置为true。
- setAfterMessagePrefix("REQUEST DATA : ")：为日志消息添加一个前缀，使得在日志文件中更容易定位请求数据。
2. 配置日志级别
CommonsRequestLoggingFilter默认在DEBUG级别输出日志。因此，为了在控制台或日志文件中看到请求体日志，我们需要为org.springframework.web.filter.CommonsRequestLoggingFilter类启用DEBUG级别的日志。
以logback.xml为例，添加以下配置：
<configuration>
<!-- 其他日志配置 -->
<logger name="org.springframework.web.filter.CommonsRequestLoggingFilter">
<level value="DEBUG" />
</logger>
<!-- 示例：控制台输出 -->
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
</encoder>
</appender>
<root level="INFO">
<appender-ref ref="CONSOLE" />
</root>
</configuration>如果你使用的是application.properties或application.yml，可以这样配置：
application.properties:
logging.level.org.springframework.web.filter.CommonsRequestLoggingFilter=DEBUG
application.yml:
logging:
level:
org.springframework.web.filter.CommonsRequestLoggingFilter: DEBUG完成上述配置后，当有HTTP请求进入你的Spring Boot应用时，CommonsRequestLoggingFilter就会在DEBUG级别记录请求的详细信息，包括完整的请求体。
注意事项与总结
- 性能考量：虽然CommonsRequestLoggingFilter非常方便，但在生产环境中，尤其是在处理大量高并发请求时，记录完整的请求体可能会对性能产生轻微影响，并导致日志文件迅速增长。务必合理设置setMaxPayloadLength，并在非必要情况下关闭或限制日志输出。
- 敏感数据：请求体中可能包含敏感信息（如密码、个人身份信息等）。在生产环境中记录这些信息存在安全风险。如果必须记录，请确保采取适当的措施进行脱敏或加密，并严格控制日志的访问权限。
- 兼容性：此方法与@RequestBody注解完全兼容。CommonsRequestLoggingFilter在请求进入Spring MVC的DispatcherServlet之前执行，它读取请求体并将其重新包装，确保后续的@RequestBody处理器仍能正常访问请求体内容，而不会出现“流已关闭”的问题。
通过CommonsRequestLoggingFilter，Spring Boot提供了一种强大且非侵入式的方式来记录HTTP请求的详细信息，包括原始请求体。这极大地简化了调试和问题排查过程，同时保持了控制器代码的清洁和业务逻辑的专注。合理配置和使用此过滤器，将有效提升开发和运维效率。
