在Spring Boot中整合Spring Cloud Gateway并代理第三方应用的调用接口是一种常见的需求，尤其是在我们需要在微服务架构中提供一个统一的入口来转发请求到不同的服务的时候这种方式真的非常好用。下面我们就来介绍一下如何在SpringBoot项目中通过整合Spring Cloud Gateway来代理第三方的接口调用。

创建Spring Boot项目并添加依赖

首先，创建一个Spring Boot项目并添加Spring Cloud Gateway的相关依赖，如下所示。

<dependencies>
    <!-- Spring Boot Starter Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- Spring Cloud Gateway -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-gateway</artifactId>
    </dependency>

    <!-- Spring Cloud Dependencies -->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>Hoxton.SR12</version> <!-- 根据需要修改为最新版本 -->
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
</dependencies>

配置Spring Cloud Gateway路由

接下来就是需要在SpringBoot的配置文件中添加Gateway相关的配置，来代理第三方的请求调用，如下所示。

spring:
  cloud:
    gateway:
      routes:
        - id: third-party-api-route
          uri: https://jsonplaceholder.typicode.com
          predicates:
            - Path=/third-party-api/**
          filters:
            - StripPrefix=1

如果客户端请求的是http://localhost:8080/third-party-api/posts，则Spring Cloud Gateway将该请求代理到https://jsonplaceholder.typicode.com/posts。

添加全局过滤器

当然在某些情况下，我们可能需要添加全局的配置，来支持在请求头中添加相关的认证信息，来支持接口的调用操作，这个时候，我们就需要创建一个全局的过滤器来实现往请求头中添加认证信息的操作如下所示。

import org.springframework.cloud.gateway.filter.GlobalFilter;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.Ordered;
import org.springframework.web.server.ServerWebExchange;
import reactor.core.publisher.Mono;

@Configuration
public class CustomGlobalFilter {

    @Bean
    public GlobalFilter customFilter() {
        return (exchange, chain) -> {
            // 在请求头中添加自定义Header
            exchange.getRequest().mutate().header("X-Custom-Header", "MyCustomValue").build();
            return chain.filter(exchange);
        };
    }
}

这个全局过滤器会在每个请求的Header中添加X-Custom-Header，当然我们也可以根据自己的需求来修改过滤器的处理逻辑。

配置完成之后，我们就可以启动项目来测试相关的配置是否正常生效。

注意事项

由于Spring Cloud Gateway是基于Spring WebFlux构建的，而传统的Spring Web应用是基于Servlet容器的。因此，直接在基于Spring MVC的项目中使用Spring Cloud Gateway会导致一些兼容性问题，其中一个典型的问题就是ServerCodecConfigurer类找不到的错误，因为这个类是WebFlux特有的。

所以为了解决这个问题我们可以在项目中添加相关的依赖，因为默认情况下，Spring Boot在检测到spring-boot-starter-web时，会优先启用Spring MVC，因此需要手动配置以确保Spring Cloud Gateway的WebFlux组件能正常运行。如下所示，我们可以添加相关的依赖配置。

<dependencies>
    <!-- Spring MVC 依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- Spring Cloud Gateway 依赖 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-gateway</artifactId>
    </dependency>

    <!-- Spring WebFlux 依赖，确保 WebFlux 能正常工作 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-webflux</artifactId>
    </dependency>

    <!-- Spring Cloud 版本控制 -->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>Hoxton.SR12</version> <!-- 根据你的实际项目调整版本 -->
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
</dependencies>

这里你既保留了Spring MVC的功能，也引入了WebFlux的依赖，以确保Spring Cloud Gateway能够正常工作。

总结

通过上述配置，我们就能够使用Spring Cloud Gateway将请求代理到第三方API并进行相关的处理。如果在实际项目中我们需要进一步的功能例如认证、限流、熔断等操作，我们可以配置中添加相关的配置，因为Spring Cloud Gateway提供了强大的支持，来帮助我们完成这些操作。