Admin on Rest GraphQL Client返回空资源问题求助

我之前在结合Admin on Rest和Graphcool GraphQL客户端时也碰到过类似的资源数据为空的情况，结合我的踩坑经验，给你几个具体的排查方向：

• 检查GraphQL查询的返回结构是否符合客户端预期
  Admin on Rest的GraphQL客户端对分页查询的返回格式有明确要求：getPageOf[Resource]s必须返回包含items（资源列表数组）和totalCount（总条数）的结构，这样客户端才能正确解析分页数据。如果你的查询只返回了列表而没有总数，就可能导致资源数据显示为空。
  举个正确的查询示例：

  query getPageOfPosts($skip: Int, $first: Int) {
    getPageOfPosts(skip: $skip, first: $first) {
      items: posts
      totalCount: _postsMeta { count }
    }
  }
  

  如果你的Graphcool端点返回字段名和这个不一致，需要在客户端配置里手动做字段映射。

• 确认Next.js中客户端的初始化逻辑
  Next.js是服务端渲染框架，要注意客户端初始化的时机：

  • 避免在组件未挂载完成前发起查询，建议在useEffect或者getServerSideProps/getStaticProps中确保客户端已正确连接到Graphcool端点；
  • 再核对下客户端配置里的introspection是否真的启用，虽然你说自省工作正常，但可以打印下自省获取到的资源元数据，确认是否正确识别了资源的字段、主键等信息。

• 验证资源定义与Graphcool模型的匹配度

  • 确保Admin on Rest中定义的资源名称和Graphcool模型的复数形式完全一致（比如Graphcool模型是Post，资源要定义为posts），如果模型命名有特殊规则，需要在客户端配置里手动指定资源对应的模型名称；
  • 检查资源的primaryKey是否正确，默认是id，如果你的Graphcool模型主键是其他字段（比如uuid），必须在资源定义里添加primaryKey: 'uuid'。

• 查看网络请求和控制台日志

  • 打开浏览器开发者工具的Network标签，查看GraphQL请求的返回数据：如果返回本身就是空数组，那问题出在Graphcool端点的查询实现或者权限规则（比如Graphcool的权限设置阻止了数据返回）；如果返回了数据但客户端没解析到，那大概率是字段映射的问题；
  • 检查控制台是否有隐藏的报错，比如字段不存在、查询语法错误等，这些都可能导致客户端无法正确处理数据。

• 确认是否遗漏了必要的配置
  除了getPageOf[Resource]s和get[Resource]，虽然列表页主要用到查询，但客户端的配置里需要确保这些查询的名称被正确映射。比如在初始化客户端时，是否明确指定了queries配置，把资源和对应的查询名称关联起来？

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