升级Hibernate 5.2+后，原生SQL遗留参数(?)兼容方案咨询

方案1：启用Hibernate遗留参数支持配置 #

Hibernate 5.2+提供了配置参数，可重新启用对遗留风格?参数的支持，无需修改现有SQL语句。只需在Hibernate配置中添加以下属性：

配置方式 #

• XML配置（hibernate.cfg.xml）：

<property name="hibernate.query.legacy_sql_param_metadata_processor">ENABLED</property>

• Spring Boot配置（application.properties）：

spring.jpa.properties.hibernate.query.legacy_sql_param_metadata_processor=ENABLED

代码示例（使用替代的createNativeQuery） #

// 替代已弃用的createSQLQuery，使用createNativeQuery
String nativeSql = "SELECT * FROM user WHERE age > ? AND status = ?";
NativeQuery<User> query = session.createNativeQuery(nativeSql, User.class);
// 按顺序设置参数，无需修改SQL中的?
query.setParameter(1, 18);
query.setParameter(2, "ACTIVE");
List<User> users = query.list();

注意：该配置仅在Hibernate 5.2~5.4版本有效，Hibernate 6.x中已移除该配置，需使用方案2。

方案2：SQL语句自动转换工具（适配Hibernate 6.x或配置失效场景） #

若配置方式不可用，可编写简单工具类，自动将SQL中的?替换为?1、?2...格式的JPA风格序数参数，无需手动修改原SQL字符串。

工具类代码示例 #

public class LegacySqlConverter {
    public static String convertToJpaOrdinalParams(String legacySql) {
        int paramIndex = 1;
        StringBuilder sb = new StringBuilder();
        char[] chars = legacySql.toCharArray();
        for (int i = 0; i < chars.length; i++) {
            // 跳过转义的\?，只处理普通?
            if (chars[i] == '?' && (i == 0 || chars[i-1] != '\\')) {
                sb.append("?").append(paramIndex++);
            } else {
                sb.append(chars[i]);
            }
        }
        return sb.toString();
    }
}

使用示例 #

String originalSql = "SELECT * FROM order WHERE total > ? AND create_time >= ?";
String jpaSql = LegacySqlConverter.convertToJpaOrdinalParams(originalSql);
// 转换后jpaSql为"SELECT * FROM order WHERE total > ?1 AND create_time >= ?2"
NativeQuery<Order> query = session.createNativeQuery(jpaSql, Order.class);
query.setParameter(1, 100.0);
query.setParameter(2, LocalDate.now().minusDays(7));
List<Order> orders = query.getResultList();

方案3：自定义ParameterMetadataBuilder（进阶） #

若需更灵活的参数处理，可自定义ParameterMetadataBuilder解析遗留风格参数，但该方式复杂度较高，仅适合深度定制需求场景，一般推荐前两种方案即可。

注意事项 #

• 方案1属于过渡方案，Hibernate官方不推荐长期使用，建议后续逐步迁移到JPA风格序数参数。
• 方案2需注意处理SQL中转义的\?，避免误替换。

内容的提问来源于stack exchange，提问作者siddharth jidage