如何让Apollo GraphQL遵循对象属性的排序顺序？

问题本质 #

这是GraphQL规范结合JavaScript对象特性的默认行为：

• GraphQL规范不保证输入对象的字段顺序具有语义意义，所以Apollo等实现会默认按字段名的字母顺序解析输入对象，确保不同客户端传入的无序对象能得到一致的解析结果。
• JavaScript对象在ES6+虽有属性顺序规则，但GraphQL生态普遍将输入对象视为无序集合，不会依赖其原始顺序。

解决方案 #

1. 后端硬编码排序优先级（适合固定排序逻辑场景）

如果你的排序规则固定（比如始终先按specificity再按name排序），直接在后端数据查询逻辑中显式指定排序字段顺序，完全忽略输入对象的键顺序：

// 示例：Node.js后端排序逻辑
const sortedData = data.sort((a, b) => {
  if (a.specificity !== b.specificity) {
    return a.specificity - b.specificity; // 先按specificity升序
  }
  return a.name.localeCompare(b.name); // 再按name升序
});

这种方式无需修改前端传参或GraphQL类型定义，简单直接。

2. 自定义有序输入标量（适合动态排序场景）

如果需要支持动态调整排序字段顺序，又不想用数组，可以自定义一个保留键顺序的GraphQL标量类型：

• 定义标量类型：

scalar OrderedSortInput

type Query {
  getItems(sort: OrderedSortInput): [Item!]!
}

• 在Apollo Server中实现标量的解析逻辑，将输入解析为有序的键值对集合：

const { GraphQLScalarType } = require('graphql');

const OrderedSortInput = new GraphQLScalarType({
  name: 'OrderedSortInput',
  description: 'An object that preserves the order of its keys',
  serialize(value) {
    return Object.fromEntries(value); // 序列化时转成普通对象
  },
  parseValue(value) {
    // 解析时保留键的顺序，返回键值对数组
    return Object.entries(value);
  },
  parseLiteral(ast) {
    if (ast.kind !== 'ObjectValue') {
      throw new Error('OrderedSortInput must be an object');
    }
    // 从AST节点提取有序键值对
    return ast.fields.map(field => [field.name.value, field.value.value]);
  },
});

后端拿到解析后的有序数组后，即可按原始顺序执行排序逻辑。

3. 接受数组作为排序参数（GraphQL规范推荐方案）

虽然你不想用数组，但这是GraphQL生态中处理有序输入的标准方式，数组的顺序明确且具有语义：

• 定义输入类型：

input SortField {
  field: String!
  direction: String!
}

type Query {
  getItems(sort: [SortField!]!): [Item!]!
}

• 前端传参：

{
  sort: [
    { field: 'specificity', direction: 'asc' },
    { field: 'name', direction: 'asc' }
  ]
}

• 后端按数组顺序依次执行排序逻辑，完全符合预期。

总结 #

如果排序逻辑固定，优先用硬编码排序顺序的方式；如果需要动态排序，自定义标量是折中方案，而数组是最符合GraphQL规范的标准做法。

内容的提问来源于stack exchange，提问作者Gergő Horváth