Spring Boot+Hibernate中@ManyToOne与@JoinColumns关联顺序错误排查

问题根源 #

你碰到的错误，本质是@JoinColumns里@JoinColumn的排列顺序，和目标实体（比如Customer）中被关联列的定义顺序不匹配。Hibernate对多列关联的列顺序要求很严格，不管是不是主键列，关联时的顺序都必须和目标侧的列声明顺序完全一致。

正确顺序规则 #

• 用@JoinColumns做多列关联时，里面每个@JoinColumn的顺序，必须严格对应目标实体中被关联列的定义先后。
• 举个实际场景：如果你的Customer实体里，先定义了主键id，再定义tenant_id_，那在Order、ReturnOrder这些关联Customer的实体中，@JoinColumns里的@JoinColumn必须先写关联id的配置，再写关联tenant_id_的配置，不能搞反。

修正后的代码示例 #

假设Customer实体的列定义顺序是这样：

@Id
@Column(name = "id")
private Long id;

@Column(name = "tenant_id_")
private String tenantId;

那关联它的实体里，@JoinColumns就得这么写：

@ManyToOne
@JoinColumns({
    @JoinColumn(name = "customer_id", referencedColumnName = "id"),
    @JoinColumn(name = "tenant_id_", referencedColumnName = "tenant_id_")
})
private Customer customer;

要是把这两个@JoinColumn的顺序反过来，就会触发你遇到的那个错误。

额外提醒 #

• 如果目标实体用的是复合主键（比如@EmbeddedId），关联时的顺序也得和嵌入类里的属性定义顺序保持一致。
• 哪怕tenant_id_是用来做多租户隔离的非主键列，也得遵守这个顺序规则，Hibernate不会因为它的特殊用途网开一面。

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