GraphQL-DotNet 8.2.1 修复联邦查询参数解析问题

在 GraphQL 联邦架构中，当使用 __entities 查询时，子类型字段的参数传递会出现无法正确解析的问题。这个问题在 GraphQL-DotNet 8.0 版本引入的新参数解析代码中存在，并在 8.2.1 版本中得到修复。

问题背景

在 GraphQL 联邦架构中，__entities 是一个特殊的查询字段，用于跨服务解析实体。当网关需要从多个服务获取数据时，会使用这个字段来批量查询实体。例如：

query {
  __entities(representations: [{ __typename: "Droid", id: "123" }]) {
    ... on Droid {
      greet(name: "smith")
    }
  }
}

在 8.2.0 及之前的版本中，greet 字段的 name 参数无法正确传递给解析器。无论查询中指定了什么值，解析器接收到的始终是 null 或默认值。

技术细节

这个问题源于 v8 版本中引入的新参数解析逻辑。在联邦查询的特殊上下文中，参数解析器未能正确处理嵌套字段的参数。具体表现为：

1. 通过 C# 方法参数绑定的方式获取参数时，参数值为 null 或默认值
2. 使用 IFieldResolveContext.GetArgument 方法也无法获取正确的参数值

解决方案

GraphQL-DotNet 团队在 8.2.1 版本中修复了这个问题。修复内容包括：

1. 修正了联邦查询上下文中的参数解析逻辑
2. 确保嵌套字段的参数能够正确传递给解析器
3. 保持了与现有 API 的兼容性

升级建议

对于使用 GraphQL 联邦架构的项目，特别是依赖 __entities 查询的服务，建议尽快升级到 8.2.1 或更高版本。升级方式简单，只需更新 NuGet 包引用即可。

总结

这个修复确保了 GraphQL 联邦架构中参数传递的正确性，特别是对于复杂查询场景下的参数解析。GraphQL-DotNet 团队对这类核心功能的持续改进，为构建可靠的分布式 GraphQL 服务提供了坚实基础。