HotChocolate GraphQL按GUID过滤父分类ID及base64 ID配置问题

报错问题解决方案 #

你遇到的类型不匹配报错是因为HotChocolate的全局ID机制导致：你为ConsumerProductCategory的根ID字段显式配置了IdType，会自动把原始Guid编码为带类型信息的base64字符串，但嵌套的Parent字段的ID没有继承这个类型配置，过滤系统默认识别为原始Guid类型，你传入base64字符串就会触发类型校验失败。

有两种常用解决方式：

方式1：统一配置ID类型 #

在ConsumerProductCategoryType的Configure方法中，显式指定Parent字段的类型为ConsumerProductCategoryType，让嵌套字段继承ID的类型配置：

descriptor
    .Field(x => x.Parent)
    .Type<ConsumerProductCategoryType>()
    .Description($"{nameof(ConsumerProductCategory)} parent category.");

配置完成后，你就可以直接传入base64编码的全局ID进行Parent.ID过滤。

方式2：直接使用原始Guid过滤 #

你可以解码base64全局ID拿到原始Guid，直接在过滤条件中传入Guid值即可：

where: { parent: { id: { eq: "cfeb4c3b-0d26-429b-80e4-2d54ccaa57d8" } } }

如果需要在业务代码中解码全局ID，可以注入IIdSerializer实现：

var idSerializer = context.Service<IIdSerializer>();
Guid originalId = idSerializer.Deserialize<Guid>(encodedIdString);

全局ID相关问题解答 #

1. base64编码ID是不是行业最佳实践？ #

是，该实现符合GraphQL的Relay规范要求，编码后的全局ID包含了实体类型信息和原始ID，可以保证跨实体的ID全局唯一，避免不同类型实体出现ID重复导致的查询错误，是GraphQL生态的通用实践。

2. 能不能关闭转换直接返回原始Guid？ #

可以，只需要修改两处配置即可：

1. 将ID字段的类型配置从Type<IdType>()改为Type<UuidType>()
2. 删除ImplementsNode()相关的配置代码

修改后的示例代码如下：

descriptor
    .Field(x => x.Id)
    .Type<UuidType>()
    .Description($"{nameof(ConsumerProductCategory)} Id.");

// 移除以下Node接口实现代码
// descriptor
//    .ImplementsNode()
//    .IdField(t => t.Id)
//    .ResolveNode((context, id) => context.Service<IConsumerProductCategoryService>().GetByIdAsync(id));

关闭后返回的ID就是原始Guid字符串，过滤时直接传Guid即可，缺点是不再支持统一的node接口跨类型查询实体。

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