实现Hibernate @OneToMany关联时报Address实体id列重复映射错误如何解决

数据老陈

2026-9-27

错误原因

该报错由Address实体类的关联字段映射错误导致：

你已经将Address类的id属性通过@Id注解映射为address表的主键，对应address表的id列
配置@ManyToOne关联时，@JoinColumn(name = "id", referencedColumnName = "id")的name属性错误填写为id，相当于要求Hibernate把关联用户的外键值也存储到address表的id列，同一个列被重复映射为两个不同字段，直接触发映射异常。

另外你混淆了@JoinColumn的属性含义：name指的是当前表（address表）中存储外键的列名，你场景里这个列是fk_user_id，不是id。

解决步骤

修正Address实体类的关联配置，将@JoinColumn的name改为实际外键列名fk_user_id：

@ManyToOne
@EqualsAndHashCode.Exclude          
@JoinColumn(name = "fk_user_id", referencedColumnName = "id")
@JsonBackReference
private User user;

补充单元测试的关联保存逻辑，否则Address数据不会自动入库：

@Test
@Order(1)
public void testInsertUser() {
    User user = new User("Mario", null, "Rossi", 'M', new Date(), "XXX", "xxx@gmail.com", "329123456", new Date());
    Set<Address> addressesList = new HashSet<>();
    addressesList.add(new Address("Italy", "RM", "00100", "Via XXX 123", "near YYY", user));
    // 把地址集合绑定到用户实体
    user.setAddressesList(addressesList);
    // 保存用户时会级联保存关联的地址
    userRepository.save(user);
    assertTrue(true);
}