如何处理GraphQL（graphql-ruby）中可返回多标量类型的字段？

嘿，这个问题我之前在项目里也碰到过！GraphQL规范确实不允许联合类型包含标量，所以咱们得换个思路，下面有两个更优雅的方案，比返回JSON字符串靠谱多了：

这是最简洁的方式，直接创建一个能处理Boolean、Integer、String的自定义标量，让graphql-ruby知道怎么序列化和解析它。

示例代码：

class Types::MultiTypeScalar < GraphQL::Schema::Scalar
  description "A scalar that can be a Boolean, Integer, or String"

  def self.coerce_result(value, context)
    # 直接返回原始值，这三种类型都是JSON基础类型，客户端能直接识别
    value
  end

  def self.coerce_input(value, context)
    # 校验输入是否为允许的类型，不符合则返回nil触发验证错误
    if value.is_a?(TrueClass) || value.is_a?(FalseClass) || value.is_a?(Integer) || value.is_a?(String)
      value
    else
      nil
    end
  end
end

然后在你的对象类型里使用这个标量：

class Types::MyObject < Types::BaseObject
  field :dynamic_value, Types::MultiTypeScalar, null: false
end

这个方案的好处是字段定义简洁，客户端拿到值后可以直接根据类型做处理；缺点是如果需要额外的类型元数据，客户端得自行判断值的类型。

如果想要更明确的类型提示，避免客户端“猜”类型，可以创建一个封装对象，里面包含三个可选字段，每次只返回其中一个非null的值。

示例代码：

class Types::MultiValue < Types::BaseObject
  description "A value that can be a Boolean, Integer, or String"

  field :boolean_value, Boolean, null: true
  field :integer_value, Integer, null: true
  field :string_value, String, null: true
end

然后在Resolver里根据实际值的类型设置对应字段：

def dynamic_value
  case @model.target_value
  when TrueClass, FalseClass
    { boolean_value: @model.target_value }
  when Integer
    { integer_value: @model.target_value }
  when String
    { string_value: @model.target_value }
  end
end

客户端查询时可以明确指定要获取的字段：

query {
  myObject {
    dynamicValue {
      booleanValue
      integerValue
      stringValue
    }
  }
}

这个方案的优势是类型安全，客户端能清晰知道每个可能的字段，GraphQL的类型系统会自动做校验；缺点是字段定义和查询语句稍微繁琐一点，但胜在逻辑清晰，扩展性也更强（未来加新类型只需新增字段即可）。

• 如果场景简单，只是需要返回一个“多类型”的值，自定义标量足够用，代码少且直观。
• 如果需要严格的类型约束，或者未来可能扩展更多类型，封装对象类型更合适，也更贴合GraphQL的设计理念。

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