React/Apollo应用中GraphQL仅返回一级数据问题（Hasura服务端）

你遇到的这个问题很典型——明明查询语句里指定了嵌套的user_attribute和enum_attribute_type字段，但返回结果里只有user_attribute_values的一级数据。大概率是以下几个常见原因导致的，咱们一个个排查：

1. Hasura角色权限未配置嵌套表的访问权限 #

Hasura的权限系统是细粒度的，不仅要给user_attribute_values表配置Select权限，还要确保对应的角色能访问关联的user_attribute和enum_attribute_type表，以及这些表的指定字段：

• 登录Hasura控制台，切换到Data标签页
• 先进入user_attribute表，找到Permissions选项卡，检查你前端请求使用的角色（比如anonymous或自定义角色）的Select权限：
  • 确保勾选了允许访问该表，并且在Select columns里包含了关联到enum_attribute_type的字段（或者直接勾选所有字段测试）
• 再进入enum_attribute_type表，同样检查对应角色的Select权限，确保value字段是可访问的
• 最后回到user_attribute_values表的Permissions，确认在Select权限的Columns里，user_attribute这个关联字段是被允许的（Hasura会把关联字段作为可选项列出）

2. Hasura未正确建立表间关联关系 #

如果user_attribute_values和user_attribute之间没有建立外键关联，Hasura无法识别你查询里的嵌套字段：

• 在Hasura控制台的Data标签，进入user_attribute_values表
• 切换到Relationships选项卡，查看是否存在名为user_attribute的对象类型关联（因为attribute_id对应user_attribute的单条记录）
• 如果没有，点击Add Relationship，选择user_attribute作为关联表，关联字段设置为user_attribute_values.attribute_id → user_attribute.id，保存后重新测试查询

3. Apollo Client缓存干扰 #

有时候Apollo的默认缓存策略可能会返回旧的、不包含嵌套字段的数据，可以强制跳过缓存验证：

const { loading, error, data } = useQuery(USER_ATTRIBUTES_QUERY, {
  fetchPolicy: 'network-only' // 或者 'no-cache'，强制从服务端获取最新数据
});

4. 确认返回数据的完整结构 #

先别急着处理数据，先在代码里打印完整的data对象，确认是不是真的没有嵌套字段：

console.log('完整查询结果:', JSON.stringify(data, null, 2));

有时候可能是自己在后续代码中只提取了一级字段，误以为服务端没返回嵌套数据。

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