Spring Boot应用中GraphiQL无法正常工作的问题求助

以下是针对你遇到的GraphiQL无法正常工作问题的排查步骤：

• 确认依赖正确性
  确保项目引入了正确的Spring GraphQL starter依赖，避免使用独立的spring-graphql依赖：

  <!-- Maven 依赖 -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-graphql</artifactId>
  </dependency>
  

  // Gradle 依赖
  implementation 'org.springframework.boot:spring-boot-starter-graphql'
  

• 检查访问路径
  Spring Boot 3.1中GraphiQL的默认访问路径是/graphiql，无需添加后缀。直接访问http://localhost:[你的端口]/graphiql，如果配置了上下文路径，需要加上前缀，比如http://localhost:8080/api/graphiql。

• 验证配置生效
  确认application.properties中的配置无拼写错误：

  spring.graphql.graphiql.enabled=true
  

  启动应用后，在日志中搜索关键词GraphiQL，如果看到GraphiQL endpoint enabled at '/graphiql'的日志，说明配置已成功加载。

• 排查拦截/安全限制
  如果项目使用Spring Security或自定义拦截器，需确保放行GraphiQL和GraphQL的路径：

  @Configuration
  public class SecurityConfig {
      @Bean
      public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
          http.authorizeHttpRequests(auth -> auth
                  .requestMatchers("/graphiql", "/graphql").permitAll()
                  .anyRequest().authenticated()
          );
          return http.build();
      }
  }
  

• 检查Jar包静态资源
  解压打包后的Jar包，查看BOOT-INF/classes/META-INF/resources/graphiql目录是否存在，该目录下需包含GraphiQL的静态文件（如index.html）。如果缺失，检查打包插件配置，确保未排除相关静态资源。

• 清除浏览器缓存
  浏览器缓存可能导致旧页面无法加载，尝试使用无痕模式访问GraphiQL地址。

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