Ecto fragment编译错误：Postgres JSON列查询问题求助

架构老林

2026-5-19

解决Ecto Fragment操作Postgres JSON列的编译错误

嘿，我之前也在Ecto里折腾过Postgres JSON列的查询，碰到过好几次编译错误，给你几个实用的排查方向和正确写法，应该能解决你的问题：

正确使用参数插值，避免手动转义
很多编译错误都是因为手动拼接字符串或者转义字符导致的，Ecto的fragment支持用^来安全插值变量，千万不要自己加引号或者转义。比如要匹配profile->>'username'等于某个值：
```
from u in User,
  where: fragment("?->>'username' = ?", u.profile, ^target_username)
```
这里^target_username会被Ecto自动处理为参数，既安全又不会触发编译错误。
嵌套JSON结构的正确查询写法
如果你的JSON是多层嵌套的（比如profile.settings.notifications.enabled），要用Postgres的#>>操作符配合数组路径：
```
from u in User,
  where: fragment("?#>>'{settings, notifications, enabled}' = ?", u.profile, ^"true")
```
注意路径是用大括号包裹的字符串数组，不需要手动转义逗号或者引号。
类型匹配：JSON字段与查询参数的类型对齐
比如JSON里的age是整数类型，直接用字符串匹配会导致类型不匹配，甚至编译警告。可以显式转换类型：
```
from u in User,
  where: fragment("(?->>'age')::integer = ?", u.profile, ^25)
```
如果是jsonb类型的列，还可以用@>操作符来匹配整个JSON对象，更简洁：
```
from u in User,
  where: fragment("? @> ?", u.profile, ^%{"age" => 25})
```
优先使用Ecto内置的JSON函数（Ecto 3+）
其实Ecto已经封装了一些JSON操作的函数，比直接写fragment更直观，也不容易出错。比如提取JSON字段：
```
from u in User,
  where: json_extract_path(u.profile, ["username"]) == ^target_username
```
对于jsonb列，还可以用jsonb_extract_path/2，用法类似。