如何基于Spring Integration实现代理以完整返回HTML页面及静态资源？

我正在开发一个作为第三方REST服务代理的Spring Integration应用，现有代理流程代码如下：

@Bean
public IntegrationFlow proxyFlow() {
    var parser = new SpelExpressionParser();

    return IntegrationFlows
            .from(Http.inboundGateway("/**")
                      .errorChannel("errorChannel")
                      .replyChannel("inboundReplyChannel")
                      .requestMapping(m -> m.methods(GET, PUT, POST, PATCH, DELETE)
                                            .consumes("*/*"))
                      .mappedRequestHeaders("X-*", "HTTP_REQUEST_HEADERS")
                      .mappedResponseHeaders("X-*", "HTTP_RESPONSE_HEADERS")
                      .headerExpression("http_requestAttributes", "#requestAttributes")
                      .headerExpression("http_requestParams", "#requestParams")
                      .headerExpression("http_requestUri", "#requestAttributes.request.requestURI"))

            // 利用业务规则填充出站请求的头信息
            .handle(urlTranslatorEndpoint)

            .handle(Http.outboundGateway(new SpelExpressionParser().parseExpression("headers.http_requestUrl"))
                        .httpMethodExpression(parser.parseExpression("headers.http_requestMethod"))
                        .mappedRequestHeaders("X-*", "HTTP_REQUEST_HEADERS")
                        .expectedResponseType(String.class)
                        .errorHandler(outboundErrorHandler)
                        .requestFactory(clientHttpRequestFactory))

            .channel("inboundReplyChannel")
            .get();
}

流程简述：

• 通过入站网关接收入站URL
• 利用业务规则转换URL
• 通过出站网关访问目标服务，并将响应发送回入站网关的回复通道

目前所有目标服务均返回JSON格式字符串，上述代码运行正常。

我计划新增部分目标服务，这些服务返回包含CSS和JavaScript的HTML页面。当前代码中使用expectedResponseType(String.class)时，发送到回复通道的是未解析的原始HTML响应，示例如下：

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8">
    <title>Swagger UI</title>
    <link rel="stylesheet" type="text/css" href="./swagger-ui.css" />
    <link rel="stylesheet" type="text/css" href="index.css" />
    <link rel="icon" type="image/png" href="./favicon-32x32.png" sizes="32x32" />
    <link rel="icon" type="image/png" href="./favicon-16x16.png" sizes="16x16" />
  </head>

  <body>
    <div id="swagger-ui"></div>
    <script src="./swagger-ui-bundle.js" charset="UTF-8"> </script>
    <script src="./swagger-ui-standalone-preset.js" charset="UTF-8"> </script>
    <script src="./swagger-initializer.js" charset="UTF-8"> </script>
  </body>
</html>

请问如何一次性请求并返回所有必要数据（HTML页面及关联的JS、CSS文件）？Spring Integration HTTP是否适合该场景？

解决方案与分析 #

1. 关于"一次性返回所有资源"的说明 #

浏览器加载HTML页面时，会自动发起独立请求获取页面中引用的JS、CSS、图片等静态资源，不存在原生的"一次性请求并返回所有资源"机制——除非将所有静态资源内联到HTML中（如CSS写在<style>标签、JS写在<script>标签），但这需要目标服务支持，代理层无法直接实现。

2. Spring Integration HTTP的适配调整 #

Spring Integration HTTP完全适合这类代理场景，只需对现有流程做以下调整：

(1) 移除固定响应类型，支持动态资源

将出站网关的expectedResponseType(String.class)改为动态判断或直接使用byte[].class，避免强制把二进制资源（如图片）转成字符串导致损坏：

// 方式1：动态根据响应类型判断返回类型
.handle(Http.outboundGateway(new SpelExpressionParser().parseExpression("headers.http_requestUrl"))
            .httpMethodExpression(parser.parseExpression("headers.http_requestMethod"))
            .mappedRequestHeaders("X-*", "HTTP_REQUEST_HEADERS")
            .expectedResponseTypeExpression(
                "T(org.springframework.util.MimeTypeUtils).parseMimeType(headers['Content-Type']).isCompatibleWith(T(org.springframework.util.MimeTypeUtils).TEXT_PLAIN) ? T(String) : T(byte[].class)"
            )
            .errorHandler(outboundErrorHandler)
            .requestFactory(clientHttpRequestFactory))

// 方式2：直接使用byte[]兼容所有类型
.expectedResponseType(byte[].class)

(2) 确保响应头完整传递

现有代码的mappedResponseHeaders已包含HTTP_RESPONSE_HEADERS，需保证这个配置保留，让目标服务返回的Content-Type等关键头信息完整传递给客户端，浏览器才能正确识别资源类型。

(3) 处理静态资源路径转换

如果目标服务的静态资源使用相对路径（如./swagger-ui.css），浏览器会向代理域名发起请求，此时需要确保urlTranslatorEndpoint能正确转换这些静态资源的请求URL，指向目标服务的对应资源路径。

3. 场景适配性结论 #

Spring Integration HTTP非常适合作为这类代理场景的解决方案，它能灵活处理不同类型的HTTP请求与响应，通过调整响应类型、头映射和URL转换逻辑，完全可以支持HTML页面及关联静态资源的代理需求。

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