GraphQL与PostgreSQL：非空子字段引发‘无法为非空字段返回null’错误

核心原因 #

1. GraphQL可空性是层级独立的：你给pronunciations和meanings设置nullable: "itemsAndList"，仅表示「数组本身可以为null」或「数组中的元素可以为null」，但子类型（Pronunciation/Meaning）内部字段的可空性是由各自的@Field定义单独控制的。如果Pronunciation实体的id字段没有显式设置nullable: true，GraphQL会默认它是非空字段，一旦返回null就会触发报错。
2. 原生SQL查询的空值问题：你用左连接+JSON_AGG(JSON_BUILD_OBJECT())处理关联数据，当左连接未匹配到Pronunciation记录时，JSON_BUILD_OBJECT()生成的对象中id等字段会是null；或者即使有匹配，SQL查询逻辑可能导致某些字段值为null，触发GraphQL的非空校验。

解决步骤 #

步骤1：检查子实体的字段可空性 #

如果业务允许Pronunciation/Meaning的字段为null，需要在对应的实体类中显式标记可空：

// Pronunciation.ts
@Field(() => Int, { nullable: true }) // 显式设置可空
@PrimaryGeneratedColumn()
id: number | null;

但通常主键id不应该为null，所以更推荐从SQL层面解决。

步骤2：修正原生SQL查询 #

确保生成的关联对象字段不会出现null：

• 过滤空关联记录：在JSON_AGG中加入条件，只聚合非空的Pronunciation/Meaning数据：

SELECT 
  entry.*,
  JSON_AGG(CASE WHEN meaning.id IS NOT NULL THEN JSON_BUILD_OBJECT('id', meaning.id, ...) END) AS meanings,
  JSON_AGG(CASE WHEN pronunciation.id IS NOT NULL THEN JSON_BUILD_OBJECT('id', pronunciation.id, ...) END) AS pronunciations
FROM entry
LEFT JOIN entry_meaning ON entry.id = entry_meaning.entryId
LEFT JOIN meaning ON meaning.id = entry_meaning.meaningId
LEFT JOIN pronunciation ON entry.id = pronunciation.entryId
GROUP BY entry.id;

• 用COALESCE处理字段默认值：如果某些字段可能为null，给它们设置默认值避免返回null：

JSON_BUILD_OBJECT(
  'id', pronunciation.id,
  'phonetic', COALESCE(pronunciation.phonetic, ''),
  ...
)

步骤3：验证查询结果 #

执行SQL后，检查返回的pronunciations和meanings数组中的每个对象，确保所有非空字段（比如id）都有有效值，没有null。

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