迁移至Spring Boot3.1.0与Hibernate6.2.x时查询触发数组越界及方案问询

迁移至Spring Boot 3.1.0搭配Hibernate 6.2.4.Final后，部分集成测试因IndexOutOfBoundsException失败，报错栈指向：

org.hibernate.sql.results.internal.TupleMetadata.getList(TupleMetadata.java:52)

根因分析 #

问题出在TupleMetadata类的这段代码中：

final TupleElement<?>[] array = new TupleElement[index.size()];
for ( Map.Entry<TupleElement<?>, Integer> entry : index.entrySet() ) { 
    array[entry.getValue()] = entry.getKey(); // 此处触发数组越界
}
this.list = list = Collections.unmodifiableList( Arrays.asList( array ) );

当index中的索引值大于等于数组长度时就会触发越界——因为数组是按index.size()初始化的，但索引值可能不是从0开始连续的，或者最大值超过了size()-1。

官方已修复该问题，对应Jira编号为HHH-16742，但修复版本暂未发布。

当前可选方案 #

• 等待Hibernate 6.3.0版本：周期太长，不现实
• 回退至Hibernate 5.6.x版本：会丢失Spring Boot 3.x适配的新特性，成本较高
• 临时重写TupleMetadata的逻辑：作为权宜方案，需谨慎使用

临时重写方案（基于字节码增强） #

由于TupleMetadata是Hibernate内部类，无法直接通过继承重写，可使用字节码增强工具（如Byte Buddy）在应用启动时替换有问题的代码逻辑，参考官方修复的实现思路：

1. 引入Byte Buddy依赖：

<dependency>
    <groupId>net.bytebuddy</groupId>
    <artifactId>byte-buddy</artifactId>
    <version>1.14.11</version>
</dependency>
<dependency>
    <groupId>net.bytebuddy</groupId>
    <artifactId>byte-buddy-agent</artifactId>
    <version>1.14.11</version>
</dependency>

2. 编写增强逻辑，替换TupleMetadata中初始化数组的代码：

import net.bytebuddy.ByteBuddy;
import net.bytebuddy.agent.ByteBuddyAgent;
import net.bytebuddy.dynamic.loading.ClassReloadingStrategy;
import net.bytebuddy.implementation.MethodDelegation;
import net.bytebuddy.matcher.ElementMatchers;

import java.util.*;
import java.util.Map.Entry;

public class TupleMetadataPatch {
    public static void apply() {
        ByteBuddyAgent.install();
        new ByteBuddy()
                .redefine(org.hibernate.sql.results.internal.TupleMetadata.class)
                .method(ElementMatchers.named("initializeList"))
                .intercept(MethodDelegation.to(TupleMetadataPatch.class))
                .make()
                .load(TupleMetadataPatch.class.getClassLoader(), ClassReloadingStrategy.fromInstalledAgent());
    }

    public static void initializeList(org.hibernate.sql.results.internal.TupleMetadata instance, Map<org.hibernate.query.TupleElement<?>, Integer> index) {
        // 参考官方修复逻辑：先找到最大索引值，创建对应大小的数组
        int maxIndex = index.values().stream().max(Integer::compareTo).orElse(-1);
        final org.hibernate.query.TupleElement<?>[] array = new org.hibernate.query.TupleElement<?>[maxIndex + 1];
        for (Entry<org.hibernate.query.TupleElement<?>, Integer> entry : index.entrySet()) {
            array[entry.getValue()] = entry.getKey();
        }
        // 通过反射设置list字段
        try {
            java.lang.reflect.Field field = org.hibernate.sql.results.internal.TupleMetadata.class.getDeclaredField("list");
            field.setAccessible(true);
            field.set(instance, Collections.unmodifiableList(Arrays.asList(array)));
        } catch (Exception e) {
            throw new RuntimeException("Failed to patch TupleMetadata", e);
        }
    }
}

3. 在Spring Boot应用启动前加载该补丁：

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        // 先应用补丁再启动Spring
        TupleMetadataPatch.apply();
        SpringApplication.run(Application.class, args);
    }
}

注意事项 #

• 该方案仅作为临时权宜之计，一旦升级到包含修复的Hibernate版本（如6.2.5+或6.3.0），必须立即移除该补丁，避免兼容性问题
• 字节码增强可能会影响应用启动性能，且依赖Hibernate内部类结构，若后续版本内部结构变化，补丁会失效

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