GraphQL HotChocolate找不到输入类型兼容构造函数问题排查

问题原因 #

该报错是HotChocolate在尝试反序列化实体时，找不到符合规则的构造函数导致的，触发的常见场景和对应解决方法如下：

• 场景1：将Project类作为Mutation输入参数使用，未配置对应输入类型
  HotChocolate中ObjectType<T>仅用于配置输出类型，输入类型需要单独实现InputObjectType<T>。同时输入类型默认要求对应类有公共无参构造函数，你可以选择以下任意一种方案处理：
  方案A：给Project类添加无参构造

  public class Project : BaseEntity<ProjectId>
  {
      // 新增无参构造供反序列化使用
      public Project(){}
      
      // 原有构造函数保留
      public Project(ProjectId id, string name, string description)
      {
          Id = id;
          Name = name;
          Description = description;
          Validate();
      }
      // 其余代码不变
  }
  

  方案B：给现有带参构造添加[GraphQLConstructor]属性，显式指定HotChocolate反序列化时使用该构造

  [GraphQLConstructor]
  public Project(ProjectId id, string name, string description)
  {
      Id = id;
      Name = name;
      Description = description;
      Validate();
  }
  

  注意使用该方案时，构造函数的参数名必须和GraphQL Schema中定义的输入字段名完全匹配，大小写规则要和HotChocolate的全局命名规则对齐。

• 场景2：自定义ProjectId类型未注册类型映射
  HotChocolate默认无法识别自定义强类型ID，需要单独注册对应的标量类型：

  1. 实现ProjectId对应的标量类型

  public class ProjectIdType : IdScalarType<ProjectId>
  {
      public ProjectIdType() : base("ProjectId") { }
      
      protected override ProjectId Parse(string value)
      {
          // 替换为你实际的ProjectId转换逻辑
          return new ProjectId(Guid.Parse(value));
      }
  
      protected override string Format(ProjectId value)
      {
          return value.ToString();
      }
  }
  

  2. 在GraphQL服务配置中注册该类型

  builder.Services
      .AddGraphQLServer()
      .AddQueryType<ProjectQueries>()
      .AddType<ProjectType>()
      .AddType<ProjectIdType>(); // 新增这行
  

• 场景3：私有属性无法绑定
  你的Project类的Name、Description属性为private set，反序列化时无法直接赋值，你可以选择将属性set改为public，或者在输入类型配置中开启私有成员绑定：

  public class ProjectInputType : InputObjectType<Project>
  {
      protected override void Configure(IInputObjectTypeDescriptor<Project> descriptor)
      {
          descriptor.BindFields(BindingBehavior.Implicit)
              .AllowBindingPrivateProperties();
      }
  }
  

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