Spring GraphQL：如何通过注解自动生成Schema，无需.graphql文件？

核心解决方案 #

Spring GraphQL原生支持基于注解的Schema自动生成，只需简单配置即可让GraphiQL/Playground识别并加载自动生成的Schema，无需手动编写.graphql文件。以下是具体实现步骤：

1. 依赖配置 #

确保项目引入Spring GraphQL核心依赖，无需额外添加Schema文件相关依赖：

• Maven：

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

• Gradle（Kotlin DSL）：

implementation("org.springframework.boot:spring-boot-starter-graphql")

2. 启用注解驱动的Schema生成 #

Spring Boot会自动扫描带有@QueryMapping、@MutationMapping等注解的组件，无需额外配置即可生成Schema元数据。只需保证你的查询、突变方法正确标注注解即可。

3. 配置GraphiQL加载自动生成的Schema #

默认情况下GraphiQL会读取本地.graphql文件，需修改配置让它指向Spring自动暴露的Schema端点：
在application.yml中添加：

spring:
  graphql:
    schema:
      printer:
        enabled: true # 启用Schema打印端点
    graphiql:
      enabled: true
      path: /graphiql
      schema-location: /graphql/schema # 指定从自动生成的Schema端点加载

或application.properties格式：

spring.graphql.schema.printer.enabled=true
spring.graphql.graphiql.enabled=true
spring.graphql.graphiql.path=/graphiql
spring.graphql.graphiql.schema-location=/graphql/schema

4. 验证效果 #

启动应用后访问配置的GraphiQL路径（如/graphiql），即可看到基于注解自动生成的Schema，可直接进行查询、突变测试，无需手动维护.graphql文件。

参考示例说明 #

1. techdozo示例：完全基于注解定义GraphQL操作，通过Spring GraphQL自动扫描生成Schema，同时配置GraphiQL加载自动生成的Schema，实现无.graphql文件的开发流程。
2. eh3rrera示例：采用纯注解方式构建GraphQL服务，利用Spring自动配置特性，让GraphiQL直接读取自动生成的Schema元数据，避免重复编写Schema文件。

内容的提问来源于stack exchange，提问作者AlikElzin-kilaka