GraphQL Union类型resolveType报错排查（Mercurius+Fastify+MongoDB）

核心问题分析 #

你遇到的运行时错误，本质是GraphQL无法为SearchResult Union类型的返回值确定具体的对象类型，主要由以下几个原因导致：

1. 集合与类型不匹配 #

你的search resolver中，第一个查询的db集合对应Schema里的MainAtmos类型，但SearchResult Union仅包含Surface和User。如果db返回MainAtmos文档，即便它有hasRings字段，也不属于SearchResult的合法类型，直接触发类型解析错误。

2. 类型判断逻辑不严谨 #

• 你用if (parameter.hasRings)判断Surface类型，但如果Surface文档的hasRings值为false，这个条件会不成立，导致误判。
• 若返回的文档既没有hasRings也没有username，函数返回null，违反GraphQL规则——Union类型必须为每个值解析出一个合法的对象类型。

3. 字段判断方式不合理 #

直接判断字段值而非字段是否存在，会因为MongoDB文档中字段为null/undefined时出现误判。

修复步骤 #

1. 对齐集合与Union类型范围 #

如果search需要包含MainAtmos类型，先更新Schema的Union定义：

union SearchResult = Surface | User | MainAtmos

如果不需要MainAtmos，则确保search中第一个查询的db是Surface对应的集合（而非MainAtmos集合）。

2. 优化__resolveType判断逻辑 #

改用独有字段存在性判断（而非字段值），并处理异常情况：

SearchResult: {
  __resolveType: (obj) => {
    // 用Surface独有的surfaceTemperatureC字段判断，精准度更高
    if ('surfaceTemperatureC' in obj) {
      return 'Surface';
    }
    // 用MainAtmos独有的mainAtmosphere字段判断（如果加入了该类型）
    if ('mainAtmosphere' in obj) {
      return 'MainAtmos';
    }
    // 用User独有的username字段判断
    if ('username' in obj) {
      return 'User';
    }
    // 抛出错误而非返回null，便于排查问题
    throw new Error(`无法识别的SearchResult类型: ${JSON.stringify(obj)}`);
  }
},

3. 可选：为返回数据添加类型标记（兜底方案） #

在search resolver中手动为结果添加__typename，确保类型解析万无一失：

search: async (_, { text }, context, info) => {
  const surfaceResults = await db.aggregate([{
    '$search': {
      'index': 'default',
      'text': {
        'query': text,
        'path': { 'wildcard': '*' }
      }
    }
  }]).toArray();

  const userResults = await usersDB.aggregate([{
    '$search': {
      'index': 'customers',
      'text': {
        'query': text,
        'path': { 'wildcard': '*' }
      }
    }
  }]).toArray();

  // 为每个结果添加明确的类型标记
  const markedSurfaces = surfaceResults.map(item => ({ ...item, __typename: 'Surface' }));
  const markedUsers = userResults.map(item => ({ ...item, __typename: 'User' }));

  return [...markedSurfaces, ...markedUsers];
},

验证测试 #

修改后用你的查询语句测试：

query SearchResult {
  search(text: "Elizabeth Ray ch4") {
    __typename 
    ... on Surface {
        name
        hasRings
    }
    ... on User {
        email
        accounts
    }
  }
}

如果仍有错误，查看抛出的异常信息，定位具体是哪个文档导致的类型解析失败，再针对性调整判断逻辑。

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