Laravel中查询PostgreSQL JSON列含指定Agent ID的行的方法

没问题，在Laravel里处理PostgreSQL的JSON列查询其实有好几种优雅的方式，我给你分情况说明：

一、使用Eloquent模型查询（推荐） #

如果你的表对应了Eloquent模型，直接用框架提供的JSON查询方法就很方便：

1. 基础场景：agents是ID数组 #

假设你的agents列存储的是单纯的ID数组（比如[123, 456]），可以用whereJsonContains方法直接匹配：

use App\Models\YourModel; // 替换成你的实际模型类

$targetAgentId = 123; // 你要查找的Agent ID
$matchingRows = YourModel::whereJsonContains('agents', $targetAgentId)->get();

不管你的列是json还是jsonb类型（PostgreSQL里更推荐用jsonb，查询性能更好），这个方法都能正常工作。

2. 进阶场景：agents是嵌套对象数组 #

如果agents列的结构是嵌套对象（比如[{"id": 123, "name": "张三"}, ...]），只需要指定JSON路径就能精准匹配：

$matchingRows = YourModel::whereJsonContains('agents->id', $targetAgentId)->get();

二、使用DB门面的查询构建器 #

如果不想用Eloquent，直接用DB门面操作也可以，逻辑和上面一致：

1. 用框架封装的whereJsonContains #

use Illuminate\Support\Facades\DB;

$targetAgentId = 123;
$matchingRows = DB::table('your_table_name') // 替换成你的表名
    ->whereJsonContains('agents', $targetAgentId)
    ->get();

2. 手动写原生SQL（DB::raw） #

要是你需要更灵活的原生查询，可以用PostgreSQL专属的JSON操作符：

方式一：使用@>操作符

@>是PostgreSQL里用来判断JSON数组是否包含指定元素的操作符，写法如下：

$matchingRows = DB::table('your_table_name')
    ->whereRaw("agents @> ?::jsonb", [[$targetAgentId]])
    ->get();

这里[[123]]是把ID包装成JSON数组，?::jsonb是将参数转换为jsonb类型，确保类型匹配。

方式二：展开数组查询（复杂场景适用）

如果需要对数组内的元素做更复杂的筛选，可以用jsonb_array_elements展开数组后查询：

$matchingRows = DB::table('your_table_name')
    ->whereExists(function ($query) use ($targetAgentId) {
        $query->select(DB::raw(1))
            ->from(DB::raw('jsonb_array_elements(agents) as agent'))
            ->whereRaw('agent::text = ?', [$targetAgentId]);
    })
    ->get();

三、几个注意点 #

• 优先用Laravel封装的whereJsonContains，它会自动适配不同数据库的JSON语法，比手写原生SQL更简洁且兼容。
• 确保传入的$targetAgentId类型和JSON列里的ID类型一致（比如数据库里是字符串ID，就别传数字类型），避免类型不匹配查不到结果。
• 建议把agents列设为jsonb类型，相比json类型，它支持索引，查询性能会更好。

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