Spring 5非Spring Boot项目Spring GraphQL客户端构建异常解决

问题根源分析 #

1. No suitable default ClientHttpConnector found异常：WebClient依赖底层HTTP连接器实现，Spring WebFlux默认不会自动引入Netty依赖，需手动添加对应组件。
2. NoSuchMethodError: reactor.core.publisher.MonoSink.contextView()异常：Spring 5（如5.3.x分支）默认依赖的Reactor版本低于3.4.x，而contextView()是Reactor 3.4+新增的方法，spring-graphql依赖该方法，导致版本不兼容冲突。

解决方案 #

1. 统一依赖版本，确保兼容性 #

在项目构建文件（Maven/Gradle）中明确指定兼容的版本组合：

• Spring Framework：5.3.x（建议搭配spring-graphql 1.1.x版本，该分支适配Spring 5.3+）
• Reactor：3.4.x（需匹配Spring 5.3.x的兼容范围）
• Netty：使用与Reactor Netty匹配的版本（如reactor-netty-http 1.0.x对应Reactor 3.4.x）

Maven依赖示例：

<dependencies>
    <!-- Spring GraphQL Client -->
    <dependency>
        <groupId>org.springframework.graphql</groupId>
        <artifactId>spring-graphql-client</artifactId>
        <version>1.1.5</version>
    </dependency>
    <!-- Spring WebFlux -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webflux</artifactId>
        <version>5.3.27</version>
    </dependency>
    <!-- Reactor Netty HTTP连接器 -->
    <dependency>
        <groupId>io.projectreactor.netty</groupId>
        <artifactId>reactor-netty-http</artifactId>
        <version>1.0.30</version>
    </dependency>
    <!-- Reactor Core 强制指定兼容版本 -->
    <dependency>
        <groupId>io.projectreactor</groupId>
        <artifactId>reactor-core</artifactId>
        <version>3.4.30</version>
    </dependency>
</dependencies>

2. 手动配置WebClient与GraphQL客户端 #

避免依赖自动配置，手动创建ClientHttpConnector和WebClient实例，再构建GraphQL客户端：

import org.springframework.graphql.client.DefaultGraphQlClientBuilder;
import org.springframework.graphql.client.GraphQlClient;
import org.springframework.http.client.reactive.ReactorClientHttpConnector;
import org.springframework.web.reactive.function.client.WebClient;
import reactor.netty.http.client.HttpClient;

public class GraphQLClientConfig {

    public GraphQlClient createGraphQlClient() {
        // 手动初始化HttpClient及连接器
        HttpClient httpClient = HttpClient.create();
        ReactorClientHttpConnector connector = new ReactorClientHttpConnector(httpClient);

        // 构建配置完整的WebClient
        WebClient webClient = WebClient.builder()
                .baseUrl("https://countries.trevorblades.com/")
                .clientConnector(connector)
                .build();

        // 基于WebClient构建GraphQL客户端
        return DefaultGraphQlClientBuilder.create(webClient)
                .build();
    }
}

3. 规范阻塞调用的执行方式 #

使用block()时，需设置超时时间避免无限阻塞，同时确保在合适的线程环境中执行（避免在非阻塞线程池调用阻塞方法）：

// 示例GraphQL查询调用
String query = """
    query {
        country(code: "US") {
            name
            capital
        }
    }
""";

GraphQlClient graphQlClient = new GraphQLClientConfig().createGraphQlClient();
Country country = graphQlClient.document(query)
        .retrieve("country")
        .toEntity(Country.class)
        .block(Duration.ofSeconds(10)); // 设置超时时间，防止线程挂起

4. 排查并排除依赖冲突 #

使用Maven的mvn dependency:tree或Gradle的gradle dependencies命令检查依赖树，若发现低版本的Reactor或Netty被间接引入，通过exclusions标签排除冲突依赖：

<dependency>
    <groupId>某依赖组</groupId>
    <artifactId>某依赖包</artifactId>
    <exclusions>
        <exclusion>
            <groupId>io.projectreactor</groupId>
            <artifactId>reactor-core</artifactId>
        </exclusion>
    </exclusions>
</dependency>

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