Hibernate对接MySQL多列IN查询报Operand should contain 2 column(s)如何解决

异常原因 #

你遇到的两个报错核心是参数类型不匹配：你给appIdVersionList定义的是String类型，JPA参数绑定时会把整个字符串作为单个值传入，无法匹配(appid, version)要求的两列结构，因此触发Operand should contain 2 column(s)错误，后续无法提取结果集的报错也是这个原因衍生的。
你之前拆分的appid in (:appIdList) and version in (:versionList)写法本质是两个单列IN查询的笛卡尔积匹配，自然会返回不符合组合要求的('abc', '456')这类无效记录。

解决办法 #

方案1：使用元组集合参数（最推荐）

直接将入参类型改为List<Object[]>，每个数组元素对应一组(appid, version)匹配组合，JPA会自动完成多组二元元组的参数绑定，无需手动拼接字符串，也不存在SQL注入风险。
Repository代码调整如下：

@Query(value = "select * from items where (appid, version) in :appIdVersionList", nativeQuery = true)
List<Item> getItemList(@Param("appIdVersionList") List<Object[]> appIdVersionList);

调用时构造参数即可：

// 构造需要匹配的组合列表
List<Object[]> matchPairs = new ArrayList<>();
matchPairs.add(new Object[]{"abc", "123"});
matchPairs.add(new Object[]{"xyz", "456"});
// 执行查询
List<Item> result = itemRepository.getItemList(matchPairs);

该方案适配所有支持行值表达式的数据库（MySQL、PostgreSQL等主流数据库均支持）。

方案2：动态拼接OR条件（兼容所有数据库）

如果你的数据库不支持行值表达式的IN查询，可以通过动态拼接多组(appid = ? and version = ?)的OR条件实现需求，最终执行的SQL格式如下：

select * from items 
where (appid = 'abc' and version = '123') 
   or (appid = 'xyz' and version = '456')

你可以用JPA Specification来动态构造该查询逻辑，不需要写原生SQL，适配所有关系型数据库，也可以避免无效组合的问题。

方案3：手动拼接SQL（不推荐，存在安全隐患）

如果你必须通过拼接字符串的方式实现，可以在业务层把匹配组合拼接为('abc','123'),('xyz','456')格式的字符串，直接传入查询：

@Query(value = "select * from items where (appid, version) in ?1", nativeQuery = true)
List<Item> getItemList(String appIdVersionList);

注意：该方案仅可在参数完全由内部逻辑生成、无外部用户输入的场景下使用，否则会存在严重的SQL注入风险。

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