能否在GraphQL Schema中定义含空格的有限字符串取值类型？

当然可以实现，针对你需要限制为带空格的固定字符串集合的需求，有两种常用方案：

方案1：使用枚举类型（Enum）+ 解析层映射 #

GraphQL的枚举类型本身要求标识符不能包含空格，但你可以在枚举定义里用无空格的命名，然后在解析逻辑中把这些枚举值映射为带空格的目标字符串。

示例Schema：

enum TargetValue {
  SOME_WORDS
  SOME_OTHER_WORDS
  # 继续添加其他允许的取值对应的枚举标识符
}

type Query {
  fetchDownstreamData: TargetValue
}

在后端解析逻辑中（以TypeScript为例），将下游返回的带空格字符串映射为枚举值，或者将枚举值转换为下游需要的格式：

// 映射关系
const valueMap = {
  'some words': TargetValue.SOME_WORDS,
  'some other words': TargetValue.SOME_OTHER_WORDS,
};

// 解析下游返回值时的转换
const downstreamResponse = await fetchDownstreamService();
return valueMap[downstreamResponse.targetValue];

这种方案的优势是GraphQL Playground会自动枚举可选值，给前端更好的开发体验。

方案2：自定义标量类型（Custom Scalar） #

如果需要在Schema层面直接体现带空格的取值，或者需要更灵活的校验逻辑，可以自定义标量类型，在标量的序列化/反序列化阶段校验值是否属于允许的集合。

示例Schema：

scalar AllowedTargetValue

type Query {
  fetchDownstreamData: AllowedTargetValue
}

然后实现这个标量的校验逻辑（以Apollo Server为例）：

import { GraphQLScalarType, Kind } from 'graphql';

// 定义允许的取值集合
const allowedValues = ['some words', 'some other words', /* 其他取值 */];

export const AllowedTargetValueScalar = new GraphQLScalarType({
  name: 'AllowedTargetValue',
  description: '仅允许指定的带空格字符串取值',
  // 序列化：将后端值转换为返回给客户端的格式
  serialize(value: unknown) {
    if (typeof value !== 'string' || !allowedValues.includes(value)) {
      throw new Error(`无效值，必须是：${allowedValues.join(', ')}`);
    }
    return value;
  },
  // 解析客户端传入的值
  parseValue(value: unknown) {
    if (typeof value !== 'string' || !allowedValues.includes(value)) {
      throw new Error(`无效值，必须是：${allowedValues.join(', ')}`);
    }
    return value;
  },
  // 解析GraphQL查询字面量
  parseLiteral(ast) {
    if (ast.kind !== Kind.STRING || !allowedValues.includes(ast.value)) {
      throw new Error(`无效值，必须是：${allowedValues.join(', ')}`);
    }
    return ast.value;
  },
});

方案选择 #

• 优先选枚举方案：如果可以接受用无空格标识符代替带空格取值，枚举的自动提示和类型校验更符合GraphQL的原生特性。
• 选自定义标量：如果必须在Schema中直接展示带空格的取值，或者需要更复杂的校验规则。

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