标量子查询返回NULL时JSONB路径操作静默失效，不会报错而是直接返回NULL；应改用LATERAL JOIN或COALESCE确保路径操作作用于非空值，避免数据“消失无提示”。
标量子查询返回NULL时JSONB路径失效的典型表现
PostgreSQL中用 SELECT (subquery).field 这类标量子查询提取 jsonb 字段时，如果子查询结果为 NULL（比如没匹配到行），整个表达式会直接返回 NULL，而不是继续尝试对 jsonb 做路径提取。这是最常踩的坑：你以为在取 data->'user'->>'name'，实际连 data 都是 NULL，路径操作根本没执行。
常见错误现象：ERROR: cannot extract field from a null value 不会出现——因为报错发生在路径操作阶段，而标量子查询先一步返回了 NULL，后续操作被跳过，结果静默为 NULL，导致数据“消失”却无提示。
- 务必确认子查询本身是否可能返回零行；若可能，改用
LATERAL JOIN或显式COALESCE包裹子查询结果 - 不要依赖
(SELECT data FROM ... LIMIT 1)->'user'->>'name'这种写法做兜底——LIMIT 1不解决空结果问题 - 测试时用
SELECT (SELECT NULL::jsonb) ->> 'x'验证行为：它返回NULL，而非报错
用LATERAL避免标量子查询空值中断
真正可靠的方式是把标量子查询“展开”成一行关系，让 jsonb 路径操作作用在明确非空的值上。这时 LATERAL 是唯一推荐路径——它确保右侧子查询能引用左侧列，且空结果自动过滤整行（或配合 LEFT JOIN LATERAL 保留空）。
例如从订单表查用户昵称：
SELECT o.id, u.name FROM orders o LEFT JOIN LATERAL ( SELECT data->>'nickname' AS name FROM users WHERE users.id = o.user_id ) u ON true;
这里 u.name 是明确从子查询输出的列，即使子查询无匹配，LEFT JOIN 也让 u.name 为 NULL，但不会导致整个表达式崩溃。关键点：
-
LATERAL子查询必须有明确别名（如u），字段需通过该别名引用 - 不要写
SELECT (SELECT data->>'nickname' FROM users WHERE ...)->>'name'—— 这仍是标量嵌套，空值照样中断 - 若子查询可能返回多行，加
LIMIT 1在子查询内部，而不是包在外层标量里
jsonb_path_query_array与标量子查询的性能陷阱
当你要从嵌套 jsonb 中提取多个同级属性（比如所有 tags 数组里的 id），别用标量子查询套 jsonb_array_elements。它会强制物化中间结果，严重拖慢大表查询。
正确做法是直接用 jsonb_path_query_array 一次性提取：
SELECT id, jsonb_path_query_array(data, '$.items[*].tag.id') AS tag_ids FROM events;
这比下面写法快一个数量级以上：
-- ❌ 避免：触发多次标量子查询 + 隐式嵌套循环 SELECT id, ( SELECT jsonb_agg(x->>'id') FROM jsonb_array_elements(data->'items') x ) AS tag_ids FROM events;
-
jsonb_path_query_array在 PostgreSQL 12+ 支持，语法简洁且引擎可优化 - 路径表达式中
$指向根，[*]是数组通配，.tag.id是深层键链 - 若需兼容旧版，用
jsonb_path_query配合jsonb_agg，但必须确保外层GROUP BY正确，否则聚合逻辑错乱
WHERE条件中误用标量子查询导致索引失效
在 WHERE 里写 status = (SELECT config->>'status' FROM app_config LIMIT 1) 看似方便，但 PostgreSQL 无法将该子查询下推到索引扫描层，哪怕 status 列上有 B-tree 索引，也会退化为全表扫描。
更糟的是，如果子查询涉及 jsonb 路径（如 config->'flags'->>'enabled'），还可能因函数不可 IMMUTABLE 而彻底禁用索引。
- 把配置值提前查出，用参数化查询传入（如
WHERE status = $1） - 若必须动态读配置，建生成列：
ALTER TABLE app_config ADD COLUMN enabled_flag text GENERATED ALWAYS AS (config->'flags'->>'enabled') STORED，再在该列上建索引 - 避免在
WHERE中出现任何jsonb路径操作符（->,->>,@>）包裹标量子查询——它们无法被规划器识别为可索引表达式
嵌套 JSONB 的路径提取本身不难，难在标量子查询的空值传播和执行计划不可控。一旦涉及 jsonb 和子查询混用，优先考虑 LATERAL 和 jsonb_path_query* 系列函数，而不是层层包裹括号。
