多模块Maven项目中SpringBoot GraphQL服务器无法启动求助

1. 检查Maven依赖配置 #

• 确保SpringBoot模块已正确依赖GraphQL模块：在SpringBoot模块的pom.xml中添加对应依赖，示例如下：

<dependency>
    <groupId>com.beauregard.pierre</groupId>
    <artifactId>graphql-module</artifactId>
    <version>你的模块版本号</version>
</dependency>

• 确认GraphQL starter依赖齐全，且版本与SpringBoot版本匹配，避免依赖冲突：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-graphql</artifactId>
</dependency>

2. 验证组件扫描有效性 #

• 检查GraphQL控制器类的注解是否正确：确保类上标注了@Controller或@RestController，同时@QueryMapping、@MutationMapping等GraphQL注解使用无误。
• 开启组件扫描日志排查：在SpringBoot配置文件中添加debug日志配置，查看控制器是否被成功加载：

logging.level.org.springframework.context.annotation=DEBUG

启动后搜索日志中的Candidate component class found关键字，确认你的GraphQL控制器类是否出现在结果中。

3. 简化启动类配置 #

@SpringBootApplication注解已包含@EnableAutoConfiguration和@ComponentScan功能，可简化启动类代码，避免重复配置引发的冲突：

@SpringBootApplication(scanBasePackages = {"com.beauregard.pierre.demo", "com.beauregard.pierre.graphql"})
public class RestRootApplication {
    public static void main(String[] args) {
        SpringApplication.run(RestRootApplication.class, args);
    }
}

4. 确认GraphQL服务器配置 #

• 开启GraphiQL可视化界面验证：在配置文件中开启GraphiQL，启动后访问http://localhost:8080/graphiql，若能正常打开则说明服务器已启动：

spring:
  graphql:
    graphiql:
      enabled: true

• 检查日志中是否有GraphQlAutoConfiguration相关加载记录，若缺失则可能是依赖未引入或自动配置被意外排除。

5. 排查模块打包问题 #

• 确认GraphQL模块的打包类型为jar（默认即为jar，若修改过需改回），确保打包后包含所有控制器类文件。
• 构建项目后，检查SpringBoot模块的依赖库中是否存在GraphQL模块的jar包，且包内包含你的控制器类。

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