本文旨在解决Spring Boot应用中，在利用@RequestBody注解自动反序列化请求体的同时，如何便捷地记录原始HTTP请求体的问题。我们将详细介绍如何通过配置Spring框架提供的CommonsRequestLoggingFilter来实现这一目标，从而避免手动切换参数类型，提高开发与调试效率。
在开发Spring Boot RESTful API时，我们经常使用@RequestBody注解来将传入的JSON或XML请求体自动映射到Java对象（DTO）。这种方式极大简化了数据处理，但有时，特别是在调试或与第三方系统集成时，我们需要查看未经Spring处理的原始请求体内容。直接在控制器方法中通过HttpServletRequest手动读取请求流虽然可行，但这会与@RequestBody的使用产生冲突，因为请求流只能读取一次。频繁地在两种方式之间切换，无疑会降低开发效率。
为了解决这一痛点，Spring框架提供了一个强大的工具：CommonsRequestLoggingFilter。这个过滤器可以在请求到达控制器之前拦截并记录请求的详细信息，包括完整的请求体，而不会干扰@RequestBody的正常工作。
配置CommonsRequestLoggingFilter
要启用CommonsRequestLoggingFilter，我们需要将其作为一个Spring Bean进行配置。这通常在一个@Configuration类中完成。
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);
// 设置是否包含请求体（payload）
filter.setIncludePayload(true);
// 设置请求体的最大长度，超过此长度的请求体将被截断
filter.setMaxPayloadLength(10000); // 示例：最大记录10KB的请求体
// 设置是否包含请求头
filter.setIncludeHeaders(false); // 通常不记录所有请求头以避免日志冗余和安全风险
// 设置日志消息的前缀，方便识别
filter.setAfterMessagePrefix("REQUEST DATA : ");
return filter;
}
}配置详解：
- setIncludeQueryString(true): 如果设置为true，日志中将包含请求的查询字符串。
- setIncludePayload(true): 这是关键，设置为true后，过滤器将记录请求体内容。
- setMaxPayloadLength(int maxPayloadLength): 限制记录请求体的最大长度。对于大型请求体，超出此长度的部分将被截断。合理设置此值可以防止日志文件过大。
- setIncludeHeaders(boolean includeHeaders): 设置是否包含HTTP请求头。在生产环境中，通常建议将其设置为false，以避免日志中包含敏感信息或造成日志冗余。
- setAfterMessagePrefix(String afterMessagePrefix): 设置日志消息的前缀，有助于在日志中快速定位请求数据。
启用CommonsRequestLoggingFilter的日志输出
CommonsRequestLoggingFilter默认在DEBUG级别输出日志。因此，为了在控制台或日志文件中看到请求体日志，你需要为该过滤器类启用DEBUG级别的日志。
使用Logback配置（例如在logback.xml中）：
<configuration>
<!-- 其他日志配置 -->
<logger name="org.springframework.web.filter.CommonsRequestLoggingFilter" level="DEBUG">
<appender-ref ref="CONSOLE" /> <!-- 或者其他你配置的appender -->
</logger>
<!-- 根日志级别 -->
<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完成上述配置后，当有请求进入你的Spring Boot应用时，你将在日志中看到类似以下格式的输出（具体内容取决于你的请求和配置）：
... DEBUG o.s.w.f.CommonsRequestLoggingFilter - REQUEST DATA : uri=/api/users;client=127.0.0.1;payload={"username":"testuser","email":"test@example.com"}注意事项与最佳实践
- 性能开销： 记录完整的请求体，尤其是在高并发场景下，可能会引入一定的性能开销。在生产环境中，请谨慎评估是否需要始终开启此功能，或考虑在特定环境下（如开发、测试环境）开启。
- 敏感数据： 请求体中可能包含密码、个人身份信息等敏感数据。如果开启了请求体日志，务必确保日志系统有适当的安全措施，并考虑对敏感信息进行脱敏处理，以符合数据隐私法规。
- 日志级别： 默认使用DEBUG级别输出日志是合理的，因为它允许你在需要时开启，而在生产环境通常保持关闭或设置为更高级别（如INFO），以避免不必要的日志量。
- 自定义过滤器： 如果CommonsRequestLoggingFilter的功能不能完全满足你的需求（例如，需要更复杂的条件判断来决定是否记录，或者需要自定义日志格式），你可以实现自己的javax.servlet.Filter接口，并在其中手动读取请求流（需要注意的是，如果手动读取，原始请求流可能会被消耗，影响@RequestBody。为了解决这个问题，可以包装HttpServletRequest，使其支持多次读取，例如使用ContentCachingRequestWrapper）。
总结
通过简单地配置CommonsRequestLoggingFilter并调整日志级别，我们可以在Spring Boot应用中优雅地实现请求体的统一日志记录，而无需修改控制器方法或干扰@RequestBody的功能。这种方法提供了一种非侵入式且可配置的解决方案，极大地便利了开发、调试和问题排查工作。
