使用SimpleGraphQLServlet.Builder时遭遇NoClassDefFoundError问题咨询

遇到NoClassDefFoundError通常是因为编译时能找到目标类，但运行时找不到它的定义，结合你用SimpleGraphQLServlet.Builder的场景，大概率是依赖问题或者版本不匹配导致的，这里给你几个针对性的解决方案：

1. 检查依赖版本与完整性 #

SimpleGraphQLServlet的Builder是在较新的版本中引入的（用来替代弃用的构造函数），如果你的依赖版本太旧，根本就没有这个Builder类。

• 如果你用Maven，确保graphql-java-servlet的依赖版本是支持Builder的，比如：

  <dependency>
      <groupId>com.graphql-java</groupId>
      <artifactId>graphql-java-servlet</artifactId>
      <version>12.0.0</version> <!-- 或更高的稳定版本 -->
  </dependency>
  

• 如果你用Gradle，对应的依赖配置：

  implementation 'com.graphql-java:graphql-java-servlet:12.0.0'
  

  注意：避免将依赖范围设为provided（除非你确认Servlet容器已经包含了对应版本的包），否则运行时会缺失类。

2. 验证Builder类的导入与存在性 #

在IDE中尝试跳转到SimpleGraphQLServlet.Builder类，如果IDE提示找不到，说明你的依赖确实没包含这个类，必须升级依赖版本。同时要确认导入的包是正确的：

import com.graphql.servlet.SimpleGraphQLServlet;

Builder是SimpleGraphQLServlet的内部类，不需要额外导入其他包。

3. 清理并重新构建项目 #

有时候IDE缓存或者旧的构建产物会导致类加载异常，执行以下步骤：

• 清理项目构建目录：Maven执行mvn clean，Gradle执行gradle clean
• 重新编译并打包项目：Maven执行mvn package，Gradle执行gradle war
• 重启IDE，刷新依赖（比如Maven的Reimport，Gradle的Refresh Gradle Project）

4. 排查Servlet容器的类加载冲突 #

如果是部署到Tomcat、Jetty等容器：

• 检查WAR包的WEB-INF/lib目录下是否包含graphql-java-servlet的JAR包，如果没有，说明打包时依赖没被正确包含
• 如果容器本身已经提供了旧版本的graphql相关包，会和项目依赖的新版本冲突，这种情况下可以调整依赖的<scope>为compile，或者移除容器中冲突的包

另外，给你的代码提个小优化建议：可以把graphQLServlet声明为final，并在构造方法中初始化，避免潜在的空指针异常：

@WebServlet("/graphql")
public class GraphQLEndpoint extends HttpServlet {
    private final SimpleGraphQLServlet graphQLServlet;

    public GraphQLEndpoint() throws ServletException {
        this.graphQLServlet = SimpleGraphQLServlet.builder(...).build();
    }

    @Override
    protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        graphQLServlet.service(req, resp);
    }
}

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