Spring GraphQL如何将JSON扩展标量正确映射到POJO属性

Spring for GraphQL 默认不会自动绑定JSON标量与Jackson的JsonNode/ObjectNode类型，处理Mutation输入参数时走Spring原生类型转换逻辑，遇到抽象类JsonNode时会直接尝试实例化抽象类，最终抛出抽象类实例化失败的异常。之前使用的graphql-spring-boot starter自动完成了标量注册和类型适配，因此同一份模型可以正常运行。

按以下顺序配置即可：

• 注册JSON标量
  在GraphQL配置类中把扩展Scalars提供的JSON标量注册到GraphQL运行时：

  @Configuration
  public class GraphQlConfig {
      @Bean
      public RuntimeWiringConfigurer runtimeWiringConfigurer() {
          return wiringBuilder -> wiringBuilder.scalar(ExtendedScalars.Json);
      }
  }
  

• 给字段标记对应GraphQL类型
  在POJO的动态JSON字段上添加注解，明确声明它对应JSON标量，避免框架自行猜测类型：

  @Accessors(fluent = true)
  @Builder
  @Data
  @JsonDeserialize(builder = MutationInputModel.MutationInputModelBuilder.class)
  public class MutationInputModel {
      @GraphQLInputType("JSON")
      private JsonNode data;
      // 其余字段省略
  }
  

• 补充类型转换器（上述配置仍不生效时使用）
  如果默认转换逻辑还是无法识别JsonNode类型，注册一个自定义转换器，直接通过Jackson把输入参数转成对应节点即可，避免框架尝试实例化抽象类：

  @Component
  public class JsonNodeConverter implements Converter<Map<String, Object>, JsonNode> {
      private final ObjectMapper objectMapper;
  
      public JsonNodeConverter(ObjectMapper objectMapper) {
          this.objectMapper = objectMapper;
      }
  
      @Override
      public JsonNode convert(Map<String, Object> source) {
          return objectMapper.valueToTree(source);
      }
  }
  

确保GraphQL Schema中对应输入字段的类型为JSON，和注册的标量名称完全匹配，示例定义：

input MutationInput {
  data: JSON!
}

如果要使用ObjectNode作为字段类型，只需要把上述转换器的目标泛型替换为ObjectNode即可，不需要修改其他逻辑。不建议用Map<String,Object>承接动态结构，后续序列化和节点操作会比Jackson节点类型繁琐很多。

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