JSONB数组需用jsonb_array_elements()或jsonb_array_elements_text()展开后才能GROUP BY；必须配合LATERAL关联原表，注意NULL处理、索引优化及->>提取字符串。
JSONB数组字段不能直接用 GROUP BY，必须先展开
PostgreSQL 的 jsonb_array_elements() 是唯一能将 JSONB 数组“打平”成行的函数。不经过这一步，GROUP BY 只能按整个数组分组（比如把 ["a","b"] 和 ["a"] 当作两个不同值），根本达不到“按每个元素分组”的目的。
常见错误是试图对 jsonb_path_query() 或 -> 直接分组——它们返回的是 jsonb 类型，不是标量，无法参与分组聚合。
- 必须用
jsonb_array_elements()或其变体（如jsonb_array_elements_text()）生成新行 - 如果数组元素是对象（如
[{"id":1,"name":"x"},{"id":2}]），用jsonb_array_elements()；如果是字符串或数字（如["apple","banana"]），优先用jsonb_array_elements_text()，它直接返回text类型，省去后续类型转换 - 注意：该函数是 set-returning function（SRF），只能出现在
FROM或LATERAL子句中，不能放在SELECT列表里直接调用
LATERAL 是安全展开 JSONB 数组的标配写法
直接在 FROM 里写 jsonb_array_elements_text(data->'tags') 会丢失原表其他字段，且无法关联上下文。正确做法是用 LATERAL 关联原行：
SELECT t.id, e.tag FROM items t, LATERAL jsonb_array_elements_text(t.data->'tags') AS e(tag);
这里 e(tag) 显式声明了别名和列名，后续就能对 e.tag 分组。漏掉 LATERAL 会导致语法错误或意外笛卡尔积。
-
LATERAL允许右侧表达式引用左侧表的列（如t.data），这是安全解构的前提 - 如果数组可能为
NULL或空数组，jsonb_array_elements_text()默认跳过——这通常符合预期；若需保留空/NULL 行，得配合COALESCE或外连接 - 性能上，
LATERAL展开后行数会剧增，务必在data->'tags'上建 GIN 索引（CREATE INDEX ON items USING GIN ((data->'tags'));）
分组统计时注意 NULL 和重复元素
解构后的字段（如 e.tag）可能含 NULL（原 JSONB 数组里有 null 字面量）或重复值（如 ["a","a","b"]）。直接 GROUP BY e.tag 会把 NULL 单独归为一组，重复值也会被分别计数。
使用固定的 Next.js/Tailwind/Prisma 技术栈构建并记录独立 SaaS 项目，仅将 FastAPI 用于 Python 工作负载，并遵循严格的架构规范。
- 过滤掉
NULL：在WHERE加e.tag IS NOT NULL - 去重后再统计频次：用
COUNT(DISTINCT t.id)替代COUNT(*)，避免同一行多个相同 tag 被重复计数 - 若需统计每个 tag 出现总次数（含重复），用
COUNT(*)即可；但得清楚这反映的是“tag 出现次数”，不是“有多少条记录含该 tag” - 示例：统计非空 tag 的出现次数
SELECT e.tag, COUNT(*) AS freq FROM items t, LATERAL jsonb_array_elements_text(t.data->'tags') AS e(tag) WHERE e.tag IS NOT NULL GROUP BY e.tag ORDER BY freq DESC;
嵌套对象数组要多一层路径提取
如果 JSONB 字段存的是对象数组（如 "users": [{"name":"Alice","role":"admin"},{"name":"Bob","role":"user"}]），想按 role 分组，就不能直接对整个对象分组，得先展开再取子字段：
- 用
jsonb_array_elements()展开得到每行一个jsonb对象 - 再用
->>提取字符串字段（如e.obj->>'role'），->>自动处理NULL并转为text - 避免用
->后接::text，因为->返回jsonb，NULL值转::text会变成字符串"null"，污染分组
完整写法：
SELECT e.obj->>'role' AS role, COUNT(*) FROM items t, LATERAL jsonb_array_elements(t.data->'users') AS e(obj) WHERE e.obj ? 'role' GROUP BY e.obj->>'role';
e.obj ? 'role' 过滤掉不含 role 键的对象，比 IS NOT NULL 更精准。
最易忽略的是类型隐式转换陷阱：用错提取操作符（-> vs ->>）、忽略 LATERAL 必需性、以及没意识到 jsonb_array_elements() 对 NULL 数组静默失败——这些都会让查询结果莫名少数据或报错。
