JPA-Hibernate中Office与Location的一对一映射配置问题

你犯的核心问题是：JPA默认会把@JoinColumn指定的字段当作目标实体（这里是Office）的主键来关联，但Office的主键是Integer类型的id，你却用了latitude和longitude这两个普通字段去匹配，JPA误以为你要拿Point类型的复合值去对应Office的Integer主键，直接就报类型不匹配了。

办法1：不改现有结构，关联普通字段 #

直接在Location的@OneToOne上用@JoinColumns明确指定关联的是Office的普通字段，同时要把这两个字段设为不可插入/不可更新——因为它们已经是Point嵌入式主键的一部分了，不能重复操作：

@Entity
public class Location {

    @EmbeddedId
    private Point point;
    private String country;

    @OneToOne
    @JoinColumns({
        @JoinColumn(name = "latitude", referencedColumnName = "latitude", insertable = false, updatable = false),
        @JoinColumn(name = "longitude", referencedColumnName = "longitude", insertable = false, updatable = false)
    })
    private Office office;
    // getters and setters omitted for brevity
}

这样配置后，JPA就会通过经纬度字段的值去匹配Office里的对应字段，而不是把它们当成Office的主键。

办法2：重构Office主键为嵌入式Point（更合理的设计） #

如果业务上经纬度确实是Office的唯一标识，不如直接把Office的主键改成Point，这样关联起来更顺：

修改Office：

@Entity
public class Office {

    @EmbeddedId
    private Point point;
    private String buildingName;
    // getters and setters omitted for brevity
}

然后Location里的关联就可以简化成：

@Entity
public class Location {

    @EmbeddedId
    private Point point;
    private String country;

    @OneToOne
    @MapsId // 直接复用当前的嵌入式主键关联Office
    private Office office;
    // getters and setters omitted for brevity
}

@MapsId的作用就是告诉JPA：用当前实体的嵌入式主键（Point）去关联Office的主键，自动匹配经纬度字段，不需要额外写@JoinColumn。

• 办法1适合不能改现有表结构的场景，注意要加insertable=false, updatable=false避免字段操作冲突。
• 办法2更符合领域模型，如果经纬度确实是Office的唯一标识，优先选这个，结构更清晰，还能去掉冗余的id字段。

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