如何在GraphQL Schema中定义嵌套枚举类型

结论 #

你提供的两种嵌套枚举写法都不符合GraphQL Schema语法规范，无法正常通过解析执行。

• 第一种写法问题：GraphQL枚举定义中仅允许声明独立的字符串常量值，不支持在枚举内部嵌套定义另一个枚举类型，语法层面直接不合法。
• 第二种写法问题：GraphQL枚举值不支持绑定自定义类型，枚举的每个值都是独立的常量，无法通过值: 类型的方式关联子类型定义，属于语法错误。

可行的实现方案 #

下面给两种业务中常用的实现方式，你可以根据自己的场景选择：

方案1：拉平枚举定义 #

如果不需要强层级区分，最简单的方式是把所有子类型直接合并到QueryType枚举中：

enum QueryType {
    NORMAL
    RANGE
    REGEX
    STARTSWITH
    ENDSWITH
    CONTAINS
}

优点是无需修改其他字段结构，改动量最小，适合简单的业务场景。

方案2：拆分基础类型+子类型 #

如果需要保留原有的WILDCARD大类区分，可以把两个枚举分开定义，在使用的输入/输出字段中关联使用：

# 基础查询大类
enum BaseQueryType {
    NORMAL
    RANGE
    REGEX
    WILDCARD
}

# 通配符查询子类型
enum WildcardQuerySubType {
    STARTSWITH
    ENDSWITH
    CONTAINS
}

# 示例：在查询入参中关联使用
input SearchQueryInput {
    queryType: BaseQueryType!
    # 仅当queryType取值为WILDCARD时，需要传入该参数
    wildcardSubType: WildcardQuerySubType
    queryValue: String!
}

优点是保留了原有层级逻辑，类型约束清晰，适合复杂的查询场景。

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