如何在GraphQL的enum中声明含特殊字符的字符串枚举值？

这个问题的核心在于GraphQL的枚举标识符严格遵循JavaScript的命名规则——不能包含é、á这类非ASCII特殊字符，所以直接把miércoles作为枚举项名称会触发语法错误。不过我们可以通过「枚举名称映射到目标字符串」的方式来解决，完美适配你现有的Mongoose Schema。

具体实现方案 #

GraphQL允许我们为枚举项指定对应的value值，用合法的标识符作为枚举名称，然后将value设置为你需要的带特殊字符的字符串。这样既符合GraphQL语法，又能和数据库层的定义完全匹配。

方案1：使用SDL（Schema定义语言）

如果你的GraphQL服务支持@value指令（比如Apollo Server），可以这样写：

enum Dias {
  LUNES @value(value: "lunes")
  MARTES @value(value: "martes")
  MIERCOLES @value(value: "miércoles")
  JUEVES @value(value: "jueves")
  VIERNES @value(value: "viernes")
  SABADO @value(value: "sábado")
  DOMINGO @value(value: "domingo")
}

如果你偏好小写的枚举名称（只要不含特殊字符即可），也可以这样定义：

enum Dias {
  lunes @value(value: "lunes")
  martes @value(value: "martes")
  miercoles @value(value: "miércoles")
  jueves @value(value: "jueves")
  viernes @value(value: "viernes")
  sabado @value(value: "sábado")
  domingo @value(value: "domingo")
}

方案2：使用代码定义枚举（比如Apollo Server的JavaScript/TypeScript实现）

如果是在代码中手动构建枚举类型，直接通过GraphQLEnumType来配置值映射：

const { GraphQLEnumType } = require('graphql');

const DiasEnum = new GraphQLEnumType({
  name: 'Dias',
  values: {
    LUNES: { value: 'lunes' },
    MARTES: { value: 'martes' },
    MIERCOLES: { value: 'miércoles' },
    JUEVES: { value: 'jueves' },
    VIERNES: { value: 'viernes' },
    SABADO: { value: 'sábado' },
    DOMINGO: { value: 'domingo' }
  }
});

如何验证有效性 #

当客户端发起查询时，使用枚举名称（比如MIERCOLES或miercoles）：

query GetSomething($dia: Dias!) {
  item(dia: $dia) {
    id
    dia
  }
}

后端会自动将枚举名称解析为对应的带特殊字符的字符串（miércoles），直接传入Mongoose模型即可完全匹配你定义的Schema：

// 示例：解析后的参数直接用于数据库查询
const item = await ItemModel.findOne({ dia: args.dia });

这样就不需要修改你的Mongoose Schema，同时完美解决了GraphQL枚举的语法限制问题。

内容的提问来源于stack exchange，提问作者François Romain