如何在非Spring应用服务器中集成Spring GraphQL

核心思路 #

无需启动完整Spring Boot应用，直接复用Spring GraphQL的自动配置逻辑，通过手动初始化Spring上下文并引入GraphQlAutoConfiguration相关配置类，就能创建出和Spring Boot自动配置一致的GraphQlSource实例。

具体实现步骤 #

1. 引入必要依赖 #

确保项目中包含以下核心依赖（根据Maven/Gradle等构建工具调整）：

• org.springframework.graphql:spring-graphql
• org.springframework.boot:spring-boot-autoconfigure（用于获取GraphQL自动配置类）
• 业务所需的GraphQL扩展依赖（如自定义数据处理器、Schema增强组件等）

2. 手动初始化Spring上下文 #

创建Spring应用上下文，显式注册GraphQlAutoConfiguration和你的自定义GraphQL组件，避免加载冗余的Spring Boot配置：

import org.springframework.boot.autoconfigure.graphql.GraphQlAutoConfiguration;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.graphql.execution.GraphQlSource;

public class GraphQlIntegration {
    public static GraphQlSource getGraphQlSource() {
        // 创建仅加载GraphQL相关配置的Spring上下文
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext();
        // 注册Spring GraphQL自动配置类
        context.register(GraphQlAutoConfiguration.class);
        // 注册你的自定义GraphQL组件（如DataFetcher、RuntimeWiringConfigurer实现类等）
        context.register(YourCustomGraphQlBeans.class);
        context.refresh();

        // 获取配置好的GraphQlSource实例
        return context.getBean(GraphQlSource.class);
    }
}

3. 复用自动配置特性 #

GraphQlAutoConfiguration会自动处理以下核心特性，无需手动编码：

• 自动加载classpath:graphql/schema.graphqls路径下的Schema文件
• 扫描并注册所有DataFetcher、RuntimeWiringConfigurer类型的Bean
• 配置默认的错误处理、数据加载器、执行策略等GraphQlSource基础设置

4. 适配现有服务器HTTP端点 #

在现有应用的HTTP请求处理器中，接收GraphQL查询请求，用获取到的GraphQlSource执行查询并返回结果：

// 示例：现有服务器的GraphQL请求处理逻辑
public void handleGraphQlRequest(HttpRequest request, HttpResponse response) {
    // 从请求中解析GraphQL查询语句和变量
    String query = extractQueryFromRequest(request);
    Map<String, Object> variables = extractVariablesFromRequest(request);

    // 构建执行参数并执行查询
    ExecutionInput input = ExecutionInput.newExecutionInput()
            .query(query)
            .variables(variables)
            .build();
    ExecutionResult result = getGraphQlSource().graphQl().execute(input);

    // 将执行结果写入HTTP响应
    writeResultToResponse(result, response);
}

注意事项 #

• 若现有应用已存在Spring上下文，直接将GraphQlAutoConfiguration注册到现有上下文即可，无需新建
• 如需调整自动配置细节，可通过注册GraphQlSourceCustomizerBean来修改GraphQlSource.Builder的配置
• 可通过PropertySourcesPlaceholderConfigurer加载application.properties/application.yml，用配置文件调整Schema路径、执行策略等参数

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