GraphQL Schema检查命令行异常，IDE运行正常问题求助

1. 对齐终端与IDE的运行环境 #

IntelliJ会自动加载项目配置和环境变量，而终端执行./gradlew bootRun可能缺失相关配置：

• 运行时指定对应环境的配置文件：

  ./gradlew bootRun --args='--spring.profiles.active=你的环境标识（如dev）'
  

• 检查终端的JAVA_HOME是否指向Java 21，确保和IDE使用的JDK版本一致。

2. 执行干净构建，确保编译产物最新 #

IDE可能会使用未提交的本地编译代码，而终端可能加载旧的构建产物，先执行：

./gradlew clean build bootRun

强制重新编译所有代码，保证GraphQL Resolver类被正确打包到运行classpath中。

3. 确认GraphQL Schema文件路径 #

确保你的.graphqls/.graphql文件放在src/main/resources/graphql/目录下（Spring Boot GraphQL默认扫描路径）。如果自定义了路径，需要在build.gradle中配置资源目录：

sourceSets {
    main {
        resources {
            srcDirs = ['src/main/resources', '自定义schema所在目录']
        }
    }
}

4. 验证Resolver类的注解与匹配规则 #

• 确保Resolver类添加了@Controller或@Component注解，被Spring容器扫描到；
• 方法上的@QueryMapping/@MutationMapping名称要和Schema中的字段完全匹配（大小写敏感），比如Schema定义的myQuery，Resolver方法需对应：

  @QueryMapping("myQuery")
  public List<MyRequestedClass> getMyQuery() {
      // 业务逻辑
  }
  

  或者直接将方法名设为myQuery。

5. 检查Spring组件扫描范围 #

如果Resolver类不在主应用类的包及其子包下，需在主类上指定扫描路径：

@SpringBootApplication
@ComponentScan(basePackages = {"com.your.resolver.package", "com.your.main.package"})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

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