如何在GraphQL中定义可支持两种类型的属性字段？

GraphQL 原生不支持输入类型字段使用联合类型（联合类型 Union 仅可用于输出类型），你想要的 Int | String! 语法没有原生支持，可通过以下两种方式实现同等效果：

方案1：自定义标量（最贴合需求） #

定义一个自定义标量来同时支持 Int 和非空 String 类型，由服务端自行实现校验逻辑：
首先在 SDL 中声明标量并使用：

# 声明支持Int和非空String的自定义标量
scalar IntOrString

input Data {
  activityValue: IntOrString!
}

之后在你使用的 GraphQL 服务端框架中实现该标量的校验规则：输入值必须是合法 Int，或者是非空字符串，不符合规则直接抛出参数错误即可。
该方案的优势是字段定义简洁，使用体验和 TypeScript 联合类型最接近。

方案2：拆分字段+互斥校验 #

如果不想引入自定义标量，可以拆分两个字段分别对应不同类型，服务端增加互斥校验逻辑：

input Data {
  activityIntValue: Int
  activityStringValue: String
}

业务逻辑中校验两个字段必须传且仅传其中一个，不符合规则返回参数错误即可。
该方案优势是完全使用 GraphQL 原生语法，不需要额外的标量处理逻辑，客户端可通过类型提示明确可选的传值格式；缺点是字段存在冗余，调用时需要按类型选择对应字段传入。

不推荐直接使用通用 JSON 标量实现，该方案等同于完全放弃 GraphQL 的类型校验能力，和使用 any 没有区别。

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