Hibernate生成无效SQL？H2数据库不支持多列子查询求助

我碰到过不少Hibernate和H2搭配时的这类兼容性问题，毕竟H2对多列子查询的支持确实一直比较局限。既然你用ORM就是为了屏蔽数据库差异，那可以试试下面这几个方案：

方案1：重构Criteria查询，避开多列子查询 #

这是最直接的解决思路，把原来的多列IN子查询逻辑转换成H2原生支持的写法。比如你之前可能在Criteria里构建了类似(col1, col2) IN (SELECT subCol1, subCol2 FROM ...)的条件，这种写法在H2里会触发报错。

你可以改用EXISTS子查询来替代，示例代码如下：

// 主查询Root
Root<MainEntity> root = criteria.from(MainEntity.class);
// 构建子查询
Subquery<SubEntity> subquery = criteria.subquery(SubEntity.class);
Root<SubEntity> subRoot = subquery.from(SubEntity.class);
// 关联主查询和子查询的多列条件
subquery.select(subRoot);
subquery.where(
    criteriaBuilder.equal(root.get("col1"), subRoot.get("subCol1")),
    criteriaBuilder.equal(root.get("col2"), subRoot.get("subCol2"))
);
// 用EXISTS替代多列IN
criteria.where(criteriaBuilder.exists(subquery));

这种写法生成的SQL会使用EXISTS逻辑，H2完全兼容。

方案2：升级Hibernate版本 #

你当前使用的5.2.9版本比较老旧，Hibernate在后续的5.3及以上版本中，针对H2的多列子查询做了适配优化——框架会自动将多列IN转换成H2能识别的等价SQL（比如拆分成组合条件或自动替换为EXISTS）。

升级到稳定的新版本（比如5.6.x系列，是5.x分支的最终稳定版）不仅能解决这个问题，还能修复其他已知bug，提升整体稳定性。

方案3：自定义H2方言适配 #

如果暂时无法升级Hibernate，可以自定义一个H2方言，重写SQL生成逻辑，让它自动处理多列子查询的场景。

比如继承官方的H2Dialect，覆盖相关方法：

public class CustomH2Dialect extends H2Dialect {
    @Override
    public String renderInExpression(boolean isSubQuery, String lhsExpression, String rhsExpression) {
        // 检测是否是多列子查询场景
        if (isSubQuery && lhsExpression.contains(",")) {
            // 将多列IN转换为H2支持的EXISTS逻辑
            String[] mainColumns = lhsExpression.trim().split(",");
            String subqueryAlias = "sub_query";
            // 重构子查询SQL，关联主表和子表的列
            String existsSql = "EXISTS (" + rhsExpression.replace("SELECT", "SELECT 1 FROM (SELECT ") + ") AS " + subqueryAlias + " WHERE " +
                String.join(" AND ", Arrays.stream(mainColumns)
                    .map(col -> col.trim() + " = " + subqueryAlias + "." + col.trim())
                    .toArray(String[]::new));
            return existsSql;
        }
        return super.renderInExpression(isSubQuery, lhsExpression, rhsExpression);
    }
}

然后在Hibernate配置中指定这个自定义方言：

hibernate.dialect=com.yourpackage.CustomH2Dialect

注意：这个自定义逻辑需要根据你实际的查询场景调整，确保生成的SQL语法正确。

方案4：开启H2的兼容模式 #

H2提供了兼容其他数据库的模式，切换到MySQL或PostgreSQL兼容模式后，大概率会支持多列子查询。你只需要在H2的连接URL中添加MODE参数：

jdbc:h2:mem:your_database;MODE=MySQL;DB_CLOSE_DELAY=-1

或者：

jdbc:h2:file:./local_db;MODE=PostgreSQL;DB_CLOSE_ON_EXIT=FALSE

开启兼容模式后，H2会模拟对应数据库的语法规则，多列IN子查询就能正常执行了。

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