Spring Integration：如何通过HTTP入站网关查看原始HTTP请求

如果使用的是Spring Integration的HTTP入站网关，要在mappedRequestHeaders映射操作前查看原始请求头，有几种直接的实现方式：

• 自定义请求拦截器（HandlerInterceptor）
  这是最精准的方式，拦截器会在网关处理请求、执行头映射之前触发，直接获取原始的HttpServletRequest对象来读取所有请求头。

  先实现自定义拦截器：

  import jakarta.servlet.http.HttpServletRequest;
  import jakarta.servlet.http.HttpServletResponse;
  import org.slf4j.Logger;
  import org.slf4j.LoggerFactory;
  import org.springframework.web.servlet.HandlerInterceptor;
  
  public class RawRequestHeaderLogger implements HandlerInterceptor {
      private static final Logger logger = LoggerFactory.getLogger(RawRequestHeaderLogger.class);
  
      @Override
      public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
          // 遍历并打印所有原始请求头
          logger.info("=== 原始HTTP请求头 ===");
          request.getHeaderNames().asIterator().forEachRemaining(headerName ->
              logger.info("{}: {}", headerName, request.getHeader(headerName))
          );
          return true; // 返回true允许后续请求流程继续
      }
  }
  

  然后将拦截器绑定到HTTP入站网关：

  import org.springframework.context.annotation.Bean;
  import org.springframework.context.annotation.Configuration;
  import org.springframework.integration.http.inbound.HttpRequestHandlingMessagingGateway;
  import org.springframework.integration.channel.DirectChannel;
  import org.springframework.messaging.MessageChannel;
  import java.util.Collections;
  
  @Configuration
  public class HttpGatewayConfig {
  
      @Bean
      public HttpRequestHandlingMessagingGateway httpInboundGateway() {
          HttpRequestHandlingMessagingGateway gateway = new HttpRequestHandlingMessagingGateway();
          // 配置网关的请求通道、路径等属性
          gateway.setRequestChannel(httpRequestChannel());
          gateway.setRequestMapping(m -> m.path("/api/endpoint"));
          // 添加自定义拦截器
          gateway.setInterceptors(Collections.singletonList(rawRequestHeaderLogger()));
          // 你的头映射配置
          gateway.setMappedRequestHeaders("X-*", "Authorization");
          return gateway;
      }
  
      @Bean
      public RawRequestHeaderLogger rawRequestHeaderLogger() {
          return new RawRequestHeaderLogger();
      }
  
      // 定义请求通道
      @Bean
      public MessageChannel httpRequestChannel() {
          return new DirectChannel();
      }
  }
  

• 使用全局请求日志过滤器（可选）
  如果需要全局监控所有HTTP请求（不限于该网关），可以使用Spring提供的CommonsRequestLoggingFilter，它会在请求进入时记录原始请求头。注意要调整日志级别为DEBUG才能看到详细内容：

  @Bean
  public CommonsRequestLoggingFilter requestLoggingFilter() {
      CommonsRequestLoggingFilter filter = new CommonsRequestLoggingFilter();
      filter.setIncludeHeaders(true);
      filter.setIncludeQueryString(true);
      filter.setBeforeMessagePrefix("=== 全局原始请求头 ===");
      return filter;
  }
  

核心原理 #

无论是自定义拦截器还是全局过滤器，它们的执行时机都早于HTTP入站网关的mappedRequestHeaders映射逻辑，因此能获取到未经过滤、完全原始的HTTP请求头信息。

内容的提问来源于stack exchange，提问作者italktothewind