Postgres JSONPath的.key访问器是否可安全自动展开数组？

你遇到的这个行为是PostgreSQL JSONPath的预期特性，官方称之为隐式数组展开（implicit array unwrapping），专门用于简化处理"字段可能是单个值或数组"的JSON结构场景。

特性原理 #

PostgreSQL在设计JSONPath时，考虑到实际业务中经常出现JSON结构不固定的情况（比如某个字段有时是单个对象，有时是包含多个对象的数组），因此对标准JSONPath做了扩展：

• 当你在对象上使用.key访问器时，正常返回该键对应的成员；
• 当你在数组上使用.key访问器时，PostgreSQL会自动遍历数组中的每个元素，对每个元素应用.key访问器，效果等同于显式使用[*].key遍历数组。

验证与示例 #

以你的测试代码为例：

1. 当a是数组时：

select * from (
select '{"a": [{"b": 2}, {"b": 3}]}'::jsonb as pl
) jb where (jsonb_path_exists(jb.pl, '$.a.b ? (@ == 2)'))

PostgreSQL自动展开a数组，遍历每个元素取b值，因此能匹配到值为2的元素，和$.a[*].b ? (@ == 2)的逻辑完全一致。

2. 当a是单个对象时：

select * from (
select '{"a": {"b": 2}}'::jsonb as pl
) jb where (jsonb_path_exists(jb.pl, '$.a.b ? (@ == 2)'))

正常返回对象的b成员，符合标准JSONPath的行为。

能否安全依赖 #

这个特性是PostgreSQL官方文档明确记载的，从PostgreSQL 12（首次引入JSONPath的版本）开始就存在，且后续版本一直保持兼容，可以安全依赖。但需要注意：

• 这是PostgreSQL特有的扩展，不属于SQL/JSON标准的JSONPath规范；
• 如果未来需要将代码迁移到其他支持JSONPath的数据库（比如MySQL、SQL Server），可能需要调整为标准写法[*].key来显式遍历数组。

额外验证 #

你可以用jsonb_path_query直接查看返回结果，确认隐式展开的效果：

-- 返回2和3，与$.a[*].b的结果一致
select jsonb_path_query('{"a": [{"b": 2}, {"b": 3}]}'::jsonb, '$.a.b');

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