Spring Boot3+Hibernate6迁移后H2数据库子查询IN子句失效问题

核心问题定位 #

Hibernate自动检测H2Dialect版本为0.0.0，导致其判定当前方言不支持行值构造器的IN子句语法，进而错误转换SQL（比如子查询SELECT后添加多余括号、IN子句解析异常）。

具体解决步骤 #

1. 强制指定正确的H2方言并校验依赖版本 #

• 在配置文件（application.properties/application.yml）中显式指定Hibernate方言，避免自动检测错误：

  spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.H2Dialect
  

• 检查H2数据库依赖版本，确保与Spring Boot版本适配（比如Spring Boot 3.1.x对应H2 2.2.x+），避免依赖冲突导致版本检测失效。

2. 调整行值构造器写法，兼容Hibernate解析逻辑 #

将IN子句中的多行值构造器((?1,?2),(?3,?4))替换为UNION ALL子查询形式，绕过Hibernate的错误解析：

DELETE FROM LqTable 
WHERE (calcId,Nr) IN (
    SELECT calc.calcId, lpqv2.Nr 
    FROM LqTable lpqv2 
    JOIN CalcTable calc ON calc.calcId = lpqv2.calcId 
    WHERE (calc.pId, lpqv2.Nr) IN (SELECT ?1, ?2 UNION ALL SELECT ?3, ?4)
)

3. 优化原生查询的使用方式 #

• 使用@Query(nativeQuery = true)时，完全采用H2原生支持的语法，避免Hibernate对SQL的额外转换。
• 开启SQL日志（spring.jpa.show-sql=true），输出实际执行的SQL语句，对比预期语法，精准定位转换错误点。

4. 自定义方言强制开启行值构造器支持 #

如果上述方法无效，可自定义H2方言子类，强制开启行值构造器的IN子句支持：

public class CustomH2Dialect extends H2Dialect {
    public CustomH2Dialect() {
        super();
    }

    @Override
    public boolean supportsRowValueConstructorSyntaxInInList() {
        return true;
    }
}

然后在配置文件中指定自定义方言：

spring.jpa.properties.hibernate.dialect=com.yourpackage.CustomH2Dialect

内容的提问来源于stack exchange，提问作者Mihai Ciully