OrchardCore项目中GraphQL排序功能异常分析与修复

在OrchardCore项目的开发过程中，开发者发现GraphQL查询中的排序功能存在异常。当使用createdUtc字段进行降序排序时，返回结果的排序顺序与预期不符。

问题现象

开发者尝试通过GraphQL查询获取文章列表，并指定按createdUtc字段降序排列。查询语句如下：

query MyQuery {
  article(orderBy: {createdUtc: DESC}) {
    displayText
    createdUtc
  }
}

然而返回的结果却显示为升序排列：

{
  "data": {
    "article": [
      {
        "displayText": "First",
        "createdUtc": "2025-02-11T04:51:32.6114111Z"
      },
      {
        "displayText": "Second",
        "createdUtc": "2025-02-11T04:51:41.4293335Z"
      }
    ]
  }
}

原因分析

通过查看源代码，发现问题出在排序方向的解析逻辑上。当前代码使用以下方式解析排序方向：

var direction = (OrderByDirection)property.Value.Value<int>();

这种转换方式存在两个问题：

1. 它将GraphQL传入的枚举值(如"DESC")尝试转换为整数，这会导致类型转换错误
2. 即使转换成功，也无法正确映射到OrderByDirection枚举的实际值

解决方案

正确的做法应该是直接解析字符串形式的枚举值。修改后的代码如下：

var direction = Enum.Parse<OrderByDirection>(property.Value.Value<string>());

这种修改能够：

1. 正确识别GraphQL传入的排序方向字符串("ASC"或"DESC")
2. 将其映射到对应的OrderByDirection枚举值
3. 确保排序操作按预期执行

技术背景

这个问题源于从Newtonsoft.Json迁移到System.Text.Json(STJ)时可能引入的变更。在JSON序列化/反序列化过程中，枚举值的处理方式有所不同，需要特别注意。

在GraphQL规范中，枚举值通常以字符串形式传递，因此直接解析字符串值是最可靠的方式。这种处理方式也更具可读性，与GraphQL的查询语法更加一致。

总结

排序功能是内容管理系统中的基础且重要的功能。通过修复这个排序方向解析的问题，可以确保OrchardCore项目中的GraphQL接口能够正确响应排序请求，为用户提供准确的数据展示顺序。开发者在进行JSON序列化相关功能开发时，应当特别注意枚举类型的处理方式，特别是在不同JSON库之间的迁移过程中。