Spring Boot 2.7.x与Java 17环境下GraphQL兼容问题及报错求助

错误信息 #

Error creating bean with name 'graphQLSchema' defined in class path resource [io/leangen/graphql/spqr/spring/autoconfigure/SpqrAutoConfiguration.class]: Bean instantiation via factory method failed; nested exception is org.springframework.beans.BeanInstantiationException: Failed to instantiate [graphql.schema.GraphQLSchema]: Factory method 'graphQLSchema' threw exception; nested exception is java.lang.NoClassDefFoundError: graphql/execution/batched/Batched

问题原因 #

GraphQL SPQR 0.0.4依赖的GraphQL Java版本过旧，graphql.execution.batched.Batched类在新版GraphQL Java中已被移除；同时Spring Boot 2.7.x默认依赖的GraphQL Java版本与SPQR 0.0.4不兼容，再加上Java 17的类加载机制变化，最终导致该类找不到的错误。

解决方案 #

• 优先方案：升级GraphQL SPQR版本
  将SPQR升级到1.0.0及以上的稳定版本，这些版本已适配Spring Boot 2.7.x、Java 17以及新版GraphQL Java环境。
  Maven依赖示例：

  <dependency>
      <groupId>io.leangen.graphql</groupId>
      <artifactId>spqr-spring-boot-starter</artifactId>
      <version>1.0.11</version>
  </dependency>
  

  Gradle依赖示例：

  implementation 'io.leangen.graphql:spqr-spring-boot-starter:1.0.11'
  

• 备选方案：锁定兼容的GraphQL Java版本（不推荐）
  若无法升级SPQR，可手动指定与SPQR 0.0.4兼容的旧版GraphQL Java，但此方式可能引发其他兼容性问题，需谨慎使用。

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