Spring GraphQL（WebMvc）异步模式的启用与禁用问题

1. 能否禁用Spring GraphQL的异步模式？ #

不行。Spring GraphQL的执行引擎从设计上就依赖异步机制来实现数据加载器、并行查询等核心特性，没有提供全局禁用异步的开关。就算你在控制器层用同步方法处理请求，底层GraphQL的执行流程依然会走异步逻辑，强行禁用会导致功能崩溃。

2. 如何为GraphQL端点启用async-supported？ #

Spring Boot环境下不用手动修改web.xml，以下几种方法可以解决问题：

方法一：自定义GraphQL Servlet注册Bean #

创建配置类，显式设置GraphQL Servlet的异步支持：

import org.springframework.boot.autoconfigure.graphql.servlet.GraphQlServletRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.graphql.server.webmvc.GraphQlMvcServlet;

@Configuration
public class GraphQlAsyncConfig {

    @Bean
    public GraphQlServletRegistrationBean graphQlServletRegistration(GraphQlMvcServlet graphQlMvcServlet) {
        GraphQlServletRegistrationBean registration = new GraphQlServletRegistrationBean(graphQlMvcServlet, "/graphql");
        registration.setAsyncSupported(true);
        return registration;
    }
}

方法二：为所有相关Filter开启异步支持 #

如果错误提示涉及Filter，必须确保每个参与请求处理的Filter都开启异步支持。比如注册自定义Filter时：

import org.springframework.boot.web.servlet.FilterRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.filter.OncePerRequestFilter;

@Configuration
public class FilterAsyncConfig {

    @Bean
    public FilterRegistrationBean<OncePerRequestFilter> customFilterRegistration() {
        FilterRegistrationBean<OncePerRequestFilter> registration = new FilterRegistrationBean<>();
        registration.setFilter(new CustomFilter()); // 替换成你的Filter类
        registration.addUrlPatterns("/graphql/*");
        registration.setAsyncSupported(true);
        return registration;
    }
}

方法三：通过配置文件快速开启（Spring Boot 2.6+） #

直接在application.properties或application.yml中添加配置：

spring.graphql.servlet.async-supported=true

注意：项目中所有自定义Filter都要开启异步支持，漏一个都会触发原错误。

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