外键为复合主键一部分时，JPA OneToMany关联列表为空问题排查

问题背景 #

现有已存在的Service实体新增了一个OneToMany关联到Translation实体，Translation使用复合主键。已通过SQL插入匹配translationDvId的测试数据，数据内容正确，但每个Service的translation列表始终为空。

相关代码 #

Service实体新增字段：

@Column(name = "TRANSLATION_DV_ID")
private String translationDvId;

@OneToMany(cascade = CascadeType.All, fetch = FetchType.Eager, mappedBy = "service")
private List<Translation> translation;

Translation实体代码：

@IdClass(TranslationId.class)
public class Translation {
 @Id
 @Column(name = "TRANSLATION_DV_ID")
 private String translationDvId;

 @Id
 @Column(name = "LOCALE_CD")
 private String localeCd;

 @Column(name = "TRANSLATED_NAME")
 private String translatedName;

 @Column(name = "TRANSLATED_DESC")
 private String translatedDesc;

 @ManyToOne
 @JoinColumn(name = "TRANSLATION_DV_ID", insertable = false, updatable = false)
 private Service service;
}

测试数据示例：

INSERT INTO SCHEMA.SERVICE(SERVICE_CD, TRANSLATION_DV_ID, etc, etc)
VALUES ('servicePrimaryKey', '12345', 'etc', 'etc');

INSERT INTO SCHEMA.TRANSLATION(TRANSLATION_DV_ID, LOCALE_CD, TRANSLATED_NAME, TRANSLATED_DESC)
VALUES ('12345', 'English', 'Guardian', 'Cool stuff');
INSERT INTO SCHEMA.TRANSLATION(TRANSLATION_DV_ID, LOCALE_CD, TRANSLATED_NAME, TRANSLATED_DESC)
VALUES ('12345', 'Spanish', 'Guardia', 'Cosas interesantes');

核心原因分析 #

1. 关联映射未明确关联字段：Translation的@ManyToOne注解只指定了name = "TRANSLATION_DV_ID"，但未明确referencedColumnName。JPA默认会尝试用Service的主键（SERVICE_CD）关联，而不是Service的普通字段TRANSLATION_DV_ID，导致关联关系无法正确建立。
2. 复合主键类可能未正确实现equals/hashCode：TranslationId作为复合主键类，若未正确实现equals和hashCode方法，JPA无法正确识别和匹配实体，进而导致关联查询失败。

解决步骤 #

1. 修正Translation的@ManyToOne关联配置 #

显式指定关联的Service字段，确保JPA知道用TRANSLATION_DV_ID而非主键关联：

@ManyToOne
@JoinColumn(
    name = "TRANSLATION_DV_ID", 
    referencedColumnName = "TRANSLATION_DV_ID", 
    insertable = false, 
    updatable = false
)
private Service service;

2. 确保TranslationId类正确实现equals和hashCode #

复合主键类必须实现Serializable，并重写equals和hashCode，保证JPA能正确比较实体：

public class TranslationId implements Serializable {
    private String translationDvId;
    private String localeCd;

    // 构造方法、getter、setter

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        TranslationId that = (TranslationId) o;
        return Objects.equals(translationDvId, that.translationDvId) &&
               Objects.equals(localeCd, that.localeCd);
    }

    @Override
    public int hashCode() {
        return Objects.hash(translationDvId, localeCd);
    }
}

3. 检查Service实体的字段访问权限 #

确保Service的translationDvId字段有公开的getter方法，JPA需要通过getter访问该字段以建立关联。

4. 验证查询时的关联加载策略 #

即使使用FetchType.Eager，部分情况下JPA可能不会自动触发关联查询。可以通过以下方式验证：

• 查看生成的SQL语句，确认是否包含与Translation的关联查询；
• 若未自动关联，在查询Service时使用JOIN FETCH显式加载关联数据：

  SELECT s FROM Service s JOIN FETCH s.translation WHERE s.serviceCd = :serviceCd
  

额外检查项 #

• 确认数据库中TRANSLATION_DV_ID字段的大小写与实体配置一致（部分数据库区分大小写）；
• 核对测试数据中Service和Translation的TRANSLATION_DV_ID值完全匹配，无空格或大小写差异。

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