Hibernate JPA复合外键关联问题：部分键属于主键

1. 修正实体类中的类型错误 #

你的实体类存在类型与数据库表不匹配的问题，这是后续关联失败的核心根源之一：

• TableA的主键FieldA1是Date类型，但TableAId里fieldA1被定义成了String，需改为Date
• TableB的主键FieldB2是String类型，但TableBId里fieldB2被定义成了Date，需改为String

修正后的嵌入主键类：

@Embeddable
public class TableAId implements Serializable {
   @Column(name = "field_a1", nullable = false)
   private Date fieldA1; // 修正为Date类型

   @Column(name = "field_a2", nullable = false)
   private String fieldA2;
}

@Embeddable
public class TableBId implements Serializable {
   @Column(name = "field_b1", nullable = false)
   private Date fieldB1;

   @Column(name = "field_b2", nullable = false)
   private String fieldB2; // 修正为String类型
}

2. 正确配置@OneToOne关联 #

在TableA中添加与TableB的关联字段，用@OneToOne配合@JoinColumns指定两组关联外键，明确关联TableB的主键字段：

@Entity
@Table(name = "table_a")
public class TableA implements Serializable {
   @EmbeddedId private TableAId id;

   @Column(name = "field_a3")
   private String fieldA3;

   // 新增TableB关联字段
   @OneToOne(fetch = FetchType.LAZY) // 根据业务需求设置加载策略
   @JoinColumns({
       // TableA的field_a1对应TableB的field_b1（主键字段）
       @JoinColumn(name = "field_a1", referencedColumnName = "field_b1", insertable = false, updatable = false),
       // TableA的field_a3对应TableB的field_b2（主键字段）
       @JoinColumn(name = "field_a3", referencedColumnName = "field_b2", insertable = false, updatable = false)
   })
   private TableB tableB;

   // getter、setter方法省略
}

配置说明： #

• insertable = false, updatable = false：因为field_a1是TableA的主键，field_a3是普通字段，不需要通过关联关系维护它们的插入/更新操作
• referencedColumnName必须对应TableB数据库表的实际列名，也就是TableBId中定义的主键属性对应的列

3. 编写正确的查询语句 #

现在可以通过关联实体查询所需数据，JPQL写法有两种：

方式1：返回Object数组 #

@Query("SELECT a, b.fieldB3 FROM TableA a JOIN a.tableB b WHERE b.fieldB3 = :mycode")
List<Object[]> findTableAWithBField3(@Param("mycode") String mycode);

方式2：返回封装DTO（推荐） #

先定义DTO类：

public class TableAWithB3DTO {
    private TableA tableA;
    private String fieldB3;

    public TableAWithB3DTO(TableA tableA, String fieldB3) {
        this.tableA = tableA;
        this.fieldB3 = fieldB3;
    }

    // getter方法省略
}

再编写查询语句：

@Query("SELECT new com.yourpackage.TableAWithB3DTO(a, b.fieldB3) FROM TableA a JOIN a.tableB b WHERE b.fieldB3 = :mycode")
List<TableAWithB3DTO> findTableAWithBField3(@Param("mycode") String mycode);

错误原因解析 #

你之前的配置报错Could not locate field name [FieldB2] on class [java.util.Date]，本质原因：

1. 实体主键字段类型与数据库表不匹配，导致Hibernate无法正确识别关联字段的类型
2. 错误使用@MapsId：该注解用于将关联实体的主键映射到当前实体的主键，但你的关联是「部分主键+普通字段」的组合，完全不适用@MapsId

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