如何解决Spring+JPA应用中复合键引发的IndexOutOfBounds异常

我有多个从Oracle数据库表生成的包含复合键的实体类，在IntelliJ中运行应用时遇到如下异常，多次重构后仍无法解决：

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'entityManagerFactory' defined in class path resource [org/springframework/boot/autoconfigure/orm/jpa/HibernateJpaConfiguration.class]: Index 2 out of bounds for length 2
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1802) ~[spring-beans-6.2.0.jar:6.2.0]
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:601) ~[spring-beans-6.2.0.jar:6.2.0]
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:523) ~[spring-beans-6.2.0.jar:6.2.0]
    at org.springframework.beans.factory.support.AbstractBeanFactory.lambda$doGetBean$0(AbstractBeanFactory.java:336) ~[spring-beans-6.2.0.jar:6.2.0]
    at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:288) ~[spring-beans-6.2.0.jar:6.2.0]
    at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:334) ~[spring-beans-6.2.0.jar:6.2.0]
    at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:204) ~[spring-beans-6.2.0.jar:6.2.0]
    at org.springframework.context.support.AbstractApplicationContext.finishBeanFactoryInitialization(AbstractApplicationContext.java:970) ~[spring-context-6.2.0.jar:6.2.0]
    at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:627) ~[spring-context-6.2.0.jar:6.2.0]
    at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.refresh(ServletWebServerApplicationContext.java:146) ~[spring-boot-3.4.0.jar:3.4.0]
    at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:752) ~[spring-boot-3.4.0.jar:3.4.0]
    at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:439) ~[spring-boot-3.4.0.jar:3.4.0]
    at org.springframework.boot.SpringApplication.run(SpringApplication.java:318) ~[spring-boot-3.4.0.jar:3.4.0]
    at org.springframework.boot.SpringApplication.run(SpringApplication.java:1361) ~[spring-boot-3.4.0.jar:3.4.0]
    at org.springframework.boot.SpringApplication.run(SpringApplication.java:1350) ~[spring-boot-3.4.0.jar:3.4.0]
    at com.ba.oscs.OSCSPartManagement.main(OSCSPartManagement.java:10) ~[classes/:na]
Caused by: java.lang.IndexOutOfBoundsException: Index 2 out of bounds for length 2
    at java.base/jdk.internal.util.Preconditions.outOfBounds(Preconditions.java:64) ~[na:na]
    at java.base/jdk.internal.util.Preconditions.outOfBoundsCheckIndex(Preconditions.java:70) ~[na:na]
    at java.base/jdk.internal.util.Preconditions.checkIndex(Preconditions.java:266) ~[na:na]
    at java.base/java.util.Objects.checkIndex(Objects.java:361) ~[na:na]
    at java.base/java.util.ArrayList.get(ArrayList.java:427) ~[na:na]
    at java.base/java.util.Collections$UnmodifiableList.get(Collections.java:1347) ~[na:na]
    at org.hibernate.boot.model.internal.TableBinder.linkJoinColumnWithValueOverridingNameIfImplicit(TableBinder.java:825) ~[hibernate-core-6.6.2.Final.jar:6.6.2.Final]
    at org.hibernate.boot.model.internal.TableBinder.bindNonPrimaryKeyReference(TableBinder.java:739) ~[hibernate-core-6.6.2.Final.jar:6.6.2.Final]
    at org.hibernate.boot.model.internal.TableBinder.bindExplicitColumns(TableBinder.java:584) ~[hibernate-core-6.6.2.Final.jar:6.6.2.Final]
    at org.hibernate.boot.model.internal.TableBinder.bindForeignKey(TableBinder.java:568) ~[hibernate-core-6.6.2.Final.jar:6.6.2.Final]
    at org.hibernate.boot.model.internal.ToOneFkSecondPass.doSecondPass(ToOneFkSecondPass.java:123) ~[hibernate-core-6.6.2.Final.jar:6.6.2.Final]
    at org.hibernate.boot.internal.InFlightMetadataCollectorImpl.processEndOfQueue(InFlightMetadataCollectorImpl.java:1937) ~[hibernate-core-6.6.2.Final.jar:6.6.2.Final]
    at org.hibernate.boot.internal.InFlightMetadataCollectorImpl.processFkSecondPassesInOrder(InFlightMetadataCollectorImpl.java:1886) ~[hibernate-core-6.6.2.Final.jar:6.6.2.Final]
    at org.hibernate.boot.internal.InFlightMetadataCollectorImpl.processSecondPasses(InFlightMetadataCollectorImpl.java:1794) ~[hibernate-core-6.6.2.Final.jar:6.6.2.Final]
    at org.hibernate.boot.model.process.spi.MetadataBuildingProcess.complete(MetadataBuildingProcess.java:334) ~[hibernate-core-6.6.2.Final.jar:6.6.2.Final]
    at org.hibernate.jpa.boot.internal.EntityManagerFactoryBuilderImpl.metadata(EntityManagerFactoryBuilderImpl.java:1431) ~[hibernate-core-6.6.2.Final.jar:6.6.2.Final]
    at org.hibernate.jpa.boot.internal.EntityManagerFactoryBuilderImpl.build(EntityManagerFactoryBuilderImpl.java:1502) ~[hibernate-core-6.6.2.Final.jar:6.6.2.Final]
    at org.springframework.orm.jpa.vendor.SpringHibernateJpaPersistenceProvider.createContainerEntityManagerFactory(SpringHibernateJpaPersistenceProvider.java:66) ~[spring-orm-6.2.0.jar:6.2.0]
    at org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean.createNativeEntityManagerFactory(LocalContainerEntityManagerFactoryBean.java:390) ~[spring-orm-6.2.0.jar:6.2.0]
    at org.springframework.orm.jpa.AbstractEntityManagerFactoryBean.buildNativeEntityManagerFactory(AbstractEntityManagerFactoryBean.java:419) ~[spring-orm-6.2.0.jar:6.2.0]
    at org.springframework.orm.jpa.AbstractEntityManagerFactoryBean.afterPropertiesSet(AbstractEntityManagerFactoryBean.java:400) ~[spring-orm-6.2.0.jar:6.2.0]
    at org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean.afterPropertiesSet(LocalContainerEntityManagerFactoryBean.java:366) ~[spring-orm-6.2.0.jar:6.2.0]
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.invokeInitMethods(AbstractAutowireCapableBeanFactory.java:1849) ~[spring-beans-6.2.0.jar:6.2.0]
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1798) ~[spring-beans-6.2.0.jar:6.2.0]
    ... 15 common frames omitted

实体类示例 #

@Getter
@Setter
@Entity
@Table(name = "TABLE_A", schema = "SCHEMA_A")
public class EntityA {

    @EmbeddedId
    private EntityAId id;

    @ManyToOne(fetch = FetchType.LAZY, optional = false)
    @JoinColumns({
            @JoinColumn(name = "FIELD_1", referencedColumnName = "FIELD_1", insertable = true, updatable = true),
            @JoinColumn(name = "CREATE_DATE", referencedColumnName = "CREATE_DATE", insertable = true, updatable = true)
    })
    @OnDelete(action = OnDeleteAction.RESTRICT)
    private EntityB entityB;

    @ManyToOne(fetch = FetchType.LAZY, optional = false)
    @OnDelete(action = OnDeleteAction.RESTRICT)
    @JoinColumn(name = "FIELD_2", referencedColumnName = "FIELD_2", insertable = false, updatable = false)
    private EntityC entityC;

    @Column(name = "QUANTITY", precision = 28, scale = 10)
    private BigDecimal quantity;

    @ManyToOne(fetch = FetchType.LAZY)
    @OnDelete(action = OnDeleteAction.RESTRICT)
    @JoinColumn(name = "FIELD_3", referencedColumnName = "FIELD_3")
    private EntityD entityD;

    @Column(name = "LENGTH", precision = 28, scale = 10)
    private BigDecimal length;

    @Column(name = "WIDTH", precision = 28, scale = 10)
    private BigDecimal width;

    @Column(name = "HEIGHT", precision = 28, scale = 10)
    private BigDecimal height;

    @Column(name = "WEIGHT", precision = 28, scale = 10)
    private BigDecimal weight;

    @Size(max = 30)
    @NotNull
    @Column(name = "UPDATE_USER", nullable = false, length = 30)
    private String updateUser;

    @Column(name = "UPDATE_DATE")
    private LocalDate updateDate;
}

复合键类示例 #

@Getter
@Setter
@Embeddable
public class EntityAId implements Serializable {

   private static final long serialVersionUID = 1L;

   @Size(max = 30)
   @NotNull
   @Column(name = "FIELD_1", nullable = false, length = 30)
   private String field1;

   @NotNull
   @Column(name = "CREATE_DATE", nullable = false)
   private LocalDate createDate;

   @Size(max = 3)
   @NotNull
   @Column(name = "FIELD_2", nullable = false, length = 3)
   private String field2;

   // Default constructor
   public EntityAId() {}

   // Constructor with parameters
   public EntityAId(String field1, LocalDate createDate, String field2) {
       this.field1 = field1;
       this.createDate = createDate;
       this.field2 = field2;
   }
}

这个索引越界异常是Hibernate处理复合键关联时的映射错误导致的，核心问题在于实体类中关联字段与复合键的重复映射冲突：

冲突原因 #

EntityA的@EmbeddedId包含三个字段：FIELD_1、CREATE_DATE、FIELD_2，但关联EntityB时，直接用@JoinColumns映射了FIELD_1和CREATE_DATE，且设置了insertable = true, updatable = true。Hibernate在解析映射时，会将复合键字段和关联字段视为同一组列，这种重复配置导致列的数量不匹配，触发索引越界。

修复方案 #

对于复合键中的关联字段，必须使用@MapsId来关联，避免重复映射列：

方式一：整体关联复合键 #

如果EntityB的主键是FIELD_1+CREATE_DATE的复合键，修改EntityA中EntityB的关联代码：

@ManyToOne(fetch = FetchType.LAZY, optional = false)
@MapsId
@JoinColumns({
        @JoinColumn(name = "FIELD_1", referencedColumnName = "FIELD_1", insertable = false, updatable = false),
        @JoinColumn(name = "CREATE_DATE", referencedColumnName = "CREATE_DATE", insertable = false, updatable = false)
})
@OnDelete(action = OnDeleteAction.RESTRICT)
private EntityB entityB;

方式二：拆分关联单个字段 #

更精准地指定复合键中的对应属性：

@ManyToOne(fetch = FetchType.LAZY, optional = false)
@MapsId("field1") // 对应EntityAId中的field1属性
@JoinColumn(name = "FIELD_1", referencedColumnName = "FIELD_1", insertable = false, updatable = false)
@MapsId("createDate") // 对应EntityAId中的createDate属性
@JoinColumn(name = "CREATE_DATE", referencedColumnName = "CREATE_DATE", insertable = false, updatable = false)
@OnDelete(action = OnDeleteAction.RESTRICT)
private EntityB entityB;

关键注意点 #

• insertable和updatable必须设为false，因为复合键的字段已经由@EmbeddedId负责维护，关联字段不需要再执行插入/更新操作
• 确保EntityB的主键结构与关联列完全匹配（即EntityB的主键也是FIELD_1+CREATE_DATE的复合键）
• 检查所有含复合键的实体类，排查是否存在类似的重复映射列问题

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