Hasura+Relay+Typescript项目报IRTransformer: Unknown kind `undefined`错误

常见诱因 #

• 导出的GraphQL Schema内容不完整或与查询字段不匹配：使用get-graphql-schema从Hasura拉取Schema时，若出现权限校验失败、网络波动问题，会导致本地schema.graphql文件内容截断、Relay依赖的Connection/Edge类型定义缺失，触发编译异常。
• 查询语句不符合Relay语法要求：所有查询必须使用graphql模板标签包裹，直接写为普通字符串模板会导致Relay编译器无法正确解析查询结构，将字段类型识别为undefined。
• Relay编译器配置与版本不兼容：--language typescript参数与本地安装的relay-compiler版本不匹配，或src目录下存在不符合TS语法规范的文件，都会导致遍历解析失败。
• 旧编译缓存冲突：之前生成的__generated__文件夹中的旧类型文件与新拉取的Schema不匹配，导致类型解析异常。

排查与解决步骤 #

1. 校验Schema有效性
   打开本地schema.graphql文件，确认内容完整无截断，搜索eetschema_event_connection类型是否存在，对应的where参数、group_id字段定义与查询中的写法一致。
2. 修正查询语句写法
   所有Relay查询必须引入graphql模板标签包裹，修改你的查询代码为：

import { graphql } from 'react-relay';

const getEvent = graphql`
  query CreateEventQuery {
    eetschema_event_connection(where: {group_id: {_eq: "17ee3ff5-eae1-4482-9ad6-d791a46a9799"}}) {
      edges {
        node {
          name
        }
      }
    }
  }
`;

3. 清理旧缓存再编译
   删除src目录下所有__generated__文件夹，重新执行yarn relay。
4. 验证版本兼容性
   确认本地安装的relay-compiler、react-relay版本与TypeScript版本匹配：relay-compiler 14及以上版本要求TypeScript版本≥4.5。
5. 缩小错误范围
   如果修改后仍报错，临时注释本次新增的查询后重新编译，编译通过则说明问题出在本次新增的查询写法上，仍报错则说明是其他已有查询或全局配置的问题。

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