GraphQL中relatedGoals字段枚举类型失效问题求助

问题定位 #

从错误信息枚举"enum_Goals_relatedGoals"的输入值无效："OFFENSIVE_GOAL"可以看出，数据库层面的枚举类型enum_Goals_relatedGoals不包含OFFENSIVE_GOAL这个值，或者GraphQL定义的枚举与数据库枚举存在格式不匹配（比如大小写、拼写、下划线差异）。

排查与修复步骤 #

1. 核对数据库枚举定义 #

找到存储Goal数据的表中relatedGoals字段对应的枚举类型（例如PostgreSQL中的CREATE TYPE enum_Goals_relatedGoals AS ENUM(...)），确认它包含以下两个值：

OFFENSIVE_GOAL
DEFENSIVE_GOAL

• 如果缺少目标值，执行ALTER TYPE命令补充：

  ALTER TYPE enum_Goals_relatedGoals ADD VALUE 'OFFENSIVE_GOAL';
  ALTER TYPE enum_Goals_relatedGoals ADD VALUE 'DEFENSIVE_GOAL';
  

• 如果存在大小写/拼写差异（比如数据库用小写offensive_goal），请统一修改为与GraphQL枚举完全一致的格式，或调整GraphQL枚举值匹配数据库。

2. 检查Resolver层的枚举处理逻辑 #

在createGoal的resolver中，确保没有对input.relatedGoals进行不必要的字符串转换（比如转小写、替换下划线）。示例：

// 错误示例：不当转换导致枚举值不匹配
const relatedGoals = input.relatedGoals.toLowerCase();

// 正确示例：直接传递原始枚举值
const newGoal = await prisma.goal.create({
  data: {
    ...input,
    relatedGoals: input.relatedGoals
  }
});

3. 验证客户端请求格式 #

确认Apollo Client发送的请求中，relatedGoals变量没有被错误包裹为字符串。正确的变量格式应为：

const variables = {
  studentId: "123",
  input: {
    goalName: "Test Goal",
    categories: "PERSONAL",
    relatedGoals: OFFENSIVE_GOAL, // 注意：此处无需加引号
    // 其他字段...
  }
};

若客户端错误传递字符串（比如"OFFENSIVE_GOAL"），会导致GraphQL服务器无法识别为合法枚举值。

4. 同步GraphQL Schema与数据库Schema #

确保GraphQL的RelatedGoals枚举定义与数据库枚举值完全一致：

enum RelatedGoals {
  OFFENSIVE_GOAL
  DEFENSIVE_GOAL
}

若数据库枚举值有变更，需同步更新GraphQL Schema中的对应枚举定义。

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