Hasura Console查询报'todos字段未找到'，应用内正常的原因排查

问题概述 #

在Hasura Console执行查询时抛出错误：

"field 'todos' not found in type: 'query_root'"

但基于Nhost演示应用搭建的副本项目中，访问应用内受保护的todos页面时，执行相同查询却无此错误。

补充背景：

• 管理员角色在Console中查询todos完全正常
• 创建普通用户后，用该用户ID在Console查询报错，但权限配置表面显示正常
• 应用请求Hasura时的请求头（取自Hasura日志）：

  x-hasura-role user
  x-hasura-user-id e2edb294-514b-463a-84fa-4a43e004d09a
  x-hasura-user-is-anonymous false
  

可能原因 #

1. Console未正确模拟user角色的完整请求上下文
   Hasura Console默认以admin角色运行查询，手动切换到user角色时，如果没同步设置x-hasura-user-id这类必需的身份头信息，Hasura会判定该角色没有todos字段的访问权限，进而返回字段不存在的错误——这和应用请求时携带完整身份头的情况形成差异。

2. 权限配置存在隐性漏洞
   即便权限配置表面正常，也可能存在细节问题：

   • todos表的user角色查询权限中，行级过滤依赖x-hasura-user-id，但Console切换角色时未传入该值，导致Hasura判定该角色无数据访问权限，直接隐藏了query_root中的todos字段
   • 表的权限元数据未成功加载或同步，导致配置未生效

解决方法 #

1. 在Console中正确模拟user角色的请求环境
   打开Hasura Console的GraphiQL页面，点击顶部的Modify Headers按钮，添加以下请求头：

   • x-hasura-role: user
   • x-hasura-user-id: e2edb294-514b-463a-84fa-4a43e004d09a（替换为你的目标用户ID）
     保存后重新执行查询，验证是否能正常获取todos数据。

2. 检查并重新应用权限元数据

   • 进入Hasura Console的Data -> Tables -> todos -> Permissions页面，确认user角色的查询权限配置正确：行级过滤条件关联user_id与x-hasura-user-id，列权限包含所需字段
   • 若配置无误仍报错，尝试重新加载元数据：进入Settings -> Metadata -> Reload Metadata

3. 验证Nhost与Hasura的身份同步状态
   由于是Nhost演示应用的副本，需确认身份服务与Hasura的角色映射是否正常：

   • 检查docker-compose中Hasura服务的环境变量，确保权限相关配置（如HASURA_GRAPHQL_ENABLE_REMOTE_SCHEMA_PERMISSIONS）已开启
   • 确认Nhost创建用户时，Hasura的用户角色关联已同步完成

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