GraphQL对象Schema定义问题：数字键对象无法正常定义

你遇到的核心问题是GraphQL的设计更偏向可预测的强类型结构，纯数字作为字段名不仅在语法处理上麻烦，更关键的是如果你的rank值是动态生成的（比如未来可能新增"4""5"等），硬编码字段名的方式完全没有扩展性。下面是两种更优的解决方案：

方案一：改用数组结构（推荐） #

这是最贴合GraphQL设计理念的方式，把原有的键值对转化为包含rank信息的对象数组，既灵活又易于维护：

修改后的Schema #

const typeDef = gql`
type Query {
  scoreByRank: [ScoreByRank!]!
}
type ScoreByRank {
  rank: Int!
  average: Int!
  count: Int!
}
`;

对应的数据结构调整 #

把原对象转换为数组格式：

[
  { rank: 1, average: 40, count: 15 },
  { rank: 2, average: 11, count: 2 },
  { rank: 3, average: 30, count: 2 }
]

查询示例 #

query {
  scoreByRank {
    rank
    average
    count
  }
}

这种方式的优势非常明显：不管未来新增多少rank值，Schema都不需要修改，查询能自然获取所有数据，同时完全符合GraphQL的类型系统规范。

方案二：保留键值对（仅适用于固定键场景） #

如果因为业务限制必须保留原键值对结构，你可以在定义字段时用引号包裹数字键，查询时也需要对应使用引号：

调整后的Schema #

const typeDef = gql`
type Query {
  scoreByRank: Count!
}
type Count {
  "1": Obj!
  "2": Obj!
  "3": Obj!
}
type Obj {
  average: Int!
  count: Int!
}
`;

查询示例 #

query {
  scoreByRank {
    "1" {
      average
      count
    }
    "2" {
      average
      count
    }
  }
}

但这种方式局限性极大：如果rank值是动态的，你无法提前在Schema中定义所有可能的字段，而且查询语法不够直观，完全违背了GraphQL的设计初衷，只建议在键完全固定的极端场景下使用。

总结来说，方案一的数组结构是最优选择，既满足GraphQL的规范要求，又能保证代码的可扩展性和可读性。

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