如何在jOOQ查询中正确绑定PostgreSQL数组参数？

这个问题我之前在项目里也踩过坑，本质是直接传递Java原生数组时，jOOQ默认会把它当成普通对象处理，调用其toString()方法，就出现了你看到的[Ljava.lang.Object;@1fee4fe3这种对象引用字符串。下面给你几个实用的解决办法：

1. 用jOOQ的DSL.array()包装数组 #

这是最通用的解决方案，DSL.array()会帮你把Java数组映射为对应SQL方言的数组类型，确保参数被正确解析。

举个Integer数组的例子：

// 直接传入数组元素
var query = ctx.selectFrom(SOME_TABLE)
               .where(SOME_TABLE.ID.in(DSL.array(1, 2, 3)));

// 或者传入已有的Java数组
Integer[] someIds = {1, 2, 3};
var query = ctx.selectFrom(SOME_TABLE)
               .where(SOME_TABLE.ID.in(DSL.array(someIds)));

如果需要更明确指定SQL类型，可以配合SQLDataType：

var query = ctx.selectFrom(SOME_TABLE)
               .where(SOME_TABLE.ID.in(DSL.val(DSL.array(someIds), SQLDataType.INTEGER_ARRAY)));

2. 给命名参数显式指定SQL数据类型 #

如果你一定要用命名参数someIds，绑定的时候必须明确告诉jOOQ参数的SQL数组类型，避免它默认转成字符串：

Integer[] someIds = {1, 2, 3};
// 方式1：直接绑定参数时指定类型
var query = ctx.selectFrom(SOME_TABLE)
               .where(SOME_TABLE.ID.in(":someIds"))
               .bind("someIds", someIds, SQLDataType.INTEGER_ARRAY);

// 方式2：先创建带类型的Param对象
Param<Integer[]> param = DSL.param("someIds", someIds, SQLDataType.INTEGER_ARRAY);
var query = ctx.selectFrom(SOME_TABLE)
               .where(SOME_TABLE.ID.in(param));

3. 针对特定数据库的适配方案 #

不同数据库对数组的支持差异很大，比如：

• MySQL：原生数组支持有限，更推荐直接传递集合，jOOQ会自动把集合拆成IN (?, ?, ?)的形式，更符合MySQL的使用习惯：

  List<Integer> someIds = Arrays.asList(1, 2, 3);
  var query = ctx.selectFrom(SOME_TABLE)
                 .where(SOME_TABLE.ID.in(someIds));
  

• PostgreSQL：原生支持数组类型，直接用DSL.array()就能完美适配，不需要额外处理。

常见误区提醒 #

别直接把Java数组传给DSL.val()却不指定SQL类型，比如这样写就会出问题：

// 错误写法：会触发数组的toString()，生成对象引用字符串
var query = ctx.selectFrom(SOME_TABLE)
               .where(SOME_TABLE.ID.in(DSL.val(someIds)));

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