Hot Chocolate 14 分页查询中TotalCount异常问题分析与解决方案

问题背景

在Hot Chocolate 14版本中，使用MongoDB作为数据源时，分页查询返回的totalCount值出现异常。具体表现为：当设置每页显示20条记录时，totalCount返回21；设置为30条时返回31。这个值总是比实际记录数多1，且与分页大小直接相关。

技术细节分析

版本升级前后的变化

从Hot Chocolate 13.9.x升级到14版本后，分页查询行为发生了变化。在13.9.x版本中，totalCount能正确反映实际记录数，而在14版本中出现了偏差。

配置对比

在13.9.x版本中，分页配置通过SetPagingOptions方法设置：

.SetPagingOptions(new PagingOptions { 
    MaxPageSize = 1000, 
    AllowBackwardPagination = true, 
    IncludeTotalCount = true 
})

而在14版本中，配置方式改为：

.ModifyPagingOptions(opt =>
{
    opt.MaxPageSize = 1000;
    opt.AllowBackwardPagination = true;
    opt.IncludeTotalCount = true;
})

查询实现

查询方法使用了Hot Chocolate的数据处理中间件：

[UsePaging]
[UseProjection]
[UseSorting]
public static IExecutable<LabourRateEntity> GetLabourRates(...)
{
    // 构建查询逻辑
    var query = collection.Find(combinedFilter);
    return query.AsExecutable();
}

问题根源

经过分析，这个问题是由于Hot Chocolate 14版本中MongoDB分页提供程序的实现发生了变化。在计算totalCount时，系统错误地将分页大小加到了实际记录数上，导致返回的总数总是比实际多1。

解决方案

1. 等待官方修复：Hot Chocolate团队已经确认并修复了这个问题。

2. 临时解决方案：如果需要立即解决问题，可以考虑以下方法之一：

   • 回退到13.9.x版本
   • 在客户端手动修正totalCount值
   • 实现自定义分页逻辑

最佳实践建议

1. 版本升级测试：在升级GraphQL框架版本时，应该全面测试分页功能。

2. 分页监控：实现监控机制，确保分页查询返回的数据量符合预期。

3. 文档查阅：在升级前仔细阅读版本变更说明，了解可能的行为变化。

总结

Hot Chocolate 14版本中的这个分页计数问题虽然看似简单，但反映了框架底层实现的变化对业务逻辑的影响。作为开发者，我们需要：

• 理解框架版本间的差异
• 建立完善的升级测试流程
• 对关键功能如分页保持高度关注

通过这次问题的分析和解决，我们不仅解决了当前的技术障碍，也为今后处理类似问题积累了宝贵经验。