如何让Postgraphile 4视图重新返回嵌套对象结构？

问题场景 #

你在PostGraphile 4环境中使用关联两张表的视图，原SQL语句存在语法错误，已标注修正点如下：

SELECT
  table1.fieldA,
  table1.fieldB,
  table2.fieldA AS table2_fieldA,
  table2.fieldB AS table2_fieldB
FROM table1
  -- 修正：原语句JOIN语法错误，应为JOIN table2 ON 关联条件
  JOIN table2 ON table1.table2_id = table2.id

此前该视图返回的GraphQL结果为嵌套对象结构：

{
  fieldA,
  fieldB,
  table2 {
    fieldA,
    fieldB
  }
}

现在返回的却是扁平化字段结构：

{
  fieldA,
  fieldB,
  table2_fieldA,
  table2_fieldB
}

需要恢复为嵌套对象结构的返回结果。

解决方法 #

1. 修正视图SQL语法错误 #

先修正原JOIN语句的语法错误，重新创建视图。错误的关联条件会导致PostGraphile无法正确识别表间关联，这可能是结构扁平化的直接诱因。

2. 给视图添加智能评论指定关联 #

PostGraphile通过智能评论识别视图与原表的关联关系，给视图添加@foreignKey评论明确关联规则：

-- 若table2的主键是id，且视图保留了table1的table2_id字段
COMMENT ON VIEW your_view_name IS '@foreignKey (table2_id) references table2(id)';

如果视图未保留关联id，也可通过table2的唯一字段组合指定：

COMMENT ON VIEW your_view_name IS '@foreignKey (table2_fieldA, table2_fieldB) references table2(fieldA, fieldB)';

3. 检查PostGraphile插件配置 #

确保启动PostGraphile时未禁用pg-simplify-inflector插件，该插件默认负责识别命名规则并生成嵌套关联结构。若启动命令包含--no-simplify-inflector参数，需移除；若为代码配置，确认该插件已加载。

4. 保留关联识别所需字段 #

PostGraphile识别关联依赖原表的主键或唯一键字段，建议在视图中保留table1的table2_id字段（关联table2的id），这能让PostGraphile更精准地识别嵌套关联。

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