Spring Hibernate中@MapsId一对一关联SQL生成异常问题

问题场景 #

按照JPA/Hibernate文档示例配置共享主键的一对一关联：

// Employee类
@Entity
public class Employee {
    @Id Integer id;

    @OneToOne @MapsId
    EmployeeInfo info;
    // 其他字段...
}

// EmployeeInfo类
@Entity
public class EmployeeInfo {
    @Id Integer id;
    // 其他字段...
}

预期两张表通过id字段关联，但执行empRepository.findById("123")时生成的SQL为：

select emp.id from emp left join emp_info on emp.info_id = emp_info.id

数据库中关联列实际是id而非info_id，且显式添加@MapsId时触发错误：

Error creating bean with name 'entityManagerFactory'. Association in entity is annotated '@MapsId' but refers to a property 'id' which has an explicit column mapping

解决方案 #

1. 修正Employee类映射 #

要实现共享主键关联，需明确指定关联列与主键列一致，同时避免映射冲突：

@Entity
public class Employee {
    @Id
    Integer id;

    @OneToOne
    @MapsId
    @JoinColumn(name = "id", referencedColumnName = "id")
    EmployeeInfo info;
    // 其他字段...
}

• @JoinColumn明确关联列是当前实体的id，与EmployeeInfo的id列对应
• @MapsId确保当前实体的主键值从关联的EmployeeInfo同步获取

2. 保持EmployeeInfo类配置不变 #

@Entity
public class EmployeeInfo {
    @Id
    Integer id;
    // 其他字段...
}

3. 关键注意事项 #

• 若Employee的主键配置了@GeneratedValue等生成策略，需移除，因为@MapsId要求主键值由关联实体提供，自行生成会导致冲突
• 错误提示中的“explicit column mapping”冲突，是因为主键字段的@Column注解与@JoinColumn的列名不一致导致的，若列名与字段名一致，可移除主键上的@Column注解；若需显式指定，确保@Column(name = "id")与@JoinColumn(name = "id")完全匹配

验证结果 #

调整配置后，执行查询生成的SQL会变为：

select emp.id from emp left join emp_info on emp.id = emp_info.id

与数据库的关联列配置一致。

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