Hibernate非主键与EmbeddedId的OneToMany关联查询异常问题

这种特殊的OneToMany关联确实容易踩坑，我之前也遇到过类似的问题，咱们一步步来排查和解决：

可能的根源分析 #

出现这个异常的核心原因，大概率是关联映射的配置错误，导致Hibernate在加载无关联B的P实例时，错误地触发了对B表的查询，或者无法正确解析关联条件：

• 当P没有关联任何B时，Hibernate尝试初始化关联集合bs，但因为EmbeddedId与P的列映射不匹配，生成了无效的SQL语句，进而抛出无意义异常。
• 另一种可能是集合未初始化，导致Hibernate代理集合时出现空指针或解析错误。
• 复合主键（EmbeddedId）的equals/hashCode未正确实现，也可能导致Hibernate在处理关联时出现逻辑错误。

正确的映射配置示例 #

先给你一套经过验证的配置模板，对比检查你的代码：

1. P类的OneToMany关联配置 #

@Entity
public class P {
    @Id
    @Column(name = "s_i") // 假设你的主键是s_i
    private String sI;

    @Column(name = "i")
    private Long i; // 这个是关联B的普通列

    // 关键：mappedBy指向B的EmbeddedId中的p属性，同时初始化集合为空
    @OneToMany(mappedBy = "embeddedId.p", cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.LAZY)
    private List<B> bs = new ArrayList<>();

    // getter、setter、构造方法
}

这里要注意：

• 必须初始化bs为new ArrayList<>()，避免Hibernate处理空集合时出错。
• fetch = FetchType.LAZY是关键，默认不会主动查询B表，只有当你主动调用p.getBs()时才会触发查询，避免无意义的关联查询。

2. B类与EmbeddedId的配置 #

@Entity
public class B {
    @EmbeddedId
    private BEmbeddedId embeddedId;

    // 其他字段...

    // getter、setter、构造方法
}

@Embeddable
public class BEmbeddedId implements Serializable {
    @Column(name = "i")
    private Long i; // 与P的i列完全对应

    // 关联P：设置insertable=false、updatable=false，因为i字段已经由EmbeddedId维护
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "i", insertable = false, updatable = false)
    private P p;

    // 必须实现Serializable，并重写equals和hashCode
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        BEmbeddedId that = (BEmbeddedId) o;
        return Objects.equals(i, that.i) && Objects.equals(p, that.p);
    }

    @Override
    public int hashCode() {
        return Objects.hash(i, p);
    }
}

这里的核心是：

• EmbeddedId中的i列与P的i列列名完全一致（注意数据库大小写敏感问题）。
• @ManyToOne的insertable=false和updatable=false必须设置，避免Hibernate重复维护i字段。
• 复合主键必须实现Serializable，并正确重写equals和hashCode，否则Hibernate无法正确识别实体唯一性。

调试与验证步骤 #

如果配置没问题，按以下步骤排查：

1. 开启SQL日志：在Hibernate配置中开启show_sql=true，查看查询P时生成的SQL语句，确认是否多余查询了B表，以及关联条件是否正确（比如b.i = p.i）。
2. 检查P的i字段值：保存P后，确认数据库中i字段有有效值，避免关联时出现空值匹配。
3. 测试懒加载：如果fetch=FetchType.LAZY，查询P后不要主动调用p.getBs()，看是否还会抛出异常——如果不抛，说明是集合初始化时的关联查询出错。

总结 #

这种跨普通列与复合主键的关联，核心是确保映射的一致性：EmbeddedId的字段与P的列严格对应，集合正确初始化，fetch配置合理避免不必要的查询。按上面的配置调整后，应该就能解决无关联B时查询P的异常问题。

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