Spring Integration子流丢失请求头：传递范围与解决方案咨询

一、请求头需要传递的节点 #

请求头必须从HTTP入站网关开始，贯穿整个处理链路，最终传递到RESPONSE_CHANNEL节点。因为RESPONSE_CHANNEL是回复消费者的最终通道，所有需要返回给客户端的请求头（含透传的原始请求头、处理生成的新头）都要到达这里，才能被HTTP网关正确返回给调用方。

二、避免子流丢失请求头的具体方案 #

1. 调用子流时显式传递所有请求头 #

当通过handle()调用子流的flowHandler()时，默认不会自动传递所有请求头。需要在调用时配置HeaderMapper，强制传递全部头信息：

.handle(fooFlowConfiguration.flowHandler(), 
        handlerSpec -> handlerSpec.headerMapper(new DefaultHeaderMapper() {{
            setRequestHeaderNames("*");
        }}))

2. 检查子流内部的头处理逻辑 #

子流中的transform、handle等组件默认会保留请求头，但如果有自定义的头操作（比如手动删除头、过滤头），会导致头丢失。需要排查子流的每个处理步骤，移除不必要的头清理逻辑；如果需要修改消息体，使用MessageBuilder复制原始头：

// 子流中转换消息时保留原始头
.transform(message -> 
    MessageBuilder.withPayload(processPayload(message.getPayload()))
        .copyHeaders(message.getHeaders())
        .build())

3. 确保中间通道支持头传递 #

CHANNEL1这类中间通道默认是DirectChannel，天然支持头传递，但如果自定义了通道拦截器，要确保拦截器不会修改或删除请求头。

4. 完善HTTP网关的头映射配置 #

虽然你设置了mappedRequestHeaders("*")，但Spring Integration HTTP网关默认会过滤部分系统头（如Content-Length、Host）。如果需要透传这些头，需补充配置：

Http.inboundGateway("/conversions/lower")
    // ...其他配置
    .mappedRequestHeaders("*")
    .preserveHostHeader(true) // 保留Host头

三、修正后的完整示例代码 #

@Bean
public IntegrationFlow exampleFlow() {
  return IntegrationFlows.from(
      Http.inboundGateway("/conversions/lower")
          .requestMapping(r -> r.methods(HttpMethod.POST))
          .mappedRequestHeaders("*")
          .requestPayloadType(Foo.class)
          .replyChannel(RESPONSE_CHANNEL)
          .mappedResponseHeaders("*")
          .preserveHostHeader(true)
    )
    .transform(this::transforFoo)
    .channel(CHANNEL1)
    .handle(fooFlowConfiguration.flowHandler(), 
            handlerSpec -> handlerSpec.headerMapper(new DefaultHeaderMapper() {{
                setRequestHeaderNames("*");
            }}))
    .channel(RESPONSE_CHANNEL)
    .get();
}

排查技巧 #

可以通过WireTap监控各节点的消息头，定位具体丢失位置：

.channel(CHANNEL1)
.wireTap(sf -> sf.handle(message -> {
    System.out.println("CHANNEL1 节点的请求头: " + message.getHeaders());
}))

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