JPA配置Product与ProductDetail一对一关系后MySQL显示为一对多的问题

我在JPA中创建了Product和ProductDetail两个实体类，配置了一对一关联关系，但通过MySQL反向工程查看数据库结构时，却显示为一对多关系。想了解该问题的原因，以下是实体类代码：

ProductDetail 类代码 #

@Getter
@Setter
@Entity
public class ProductDetail {
    @Id @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "product_id")
    private Integer id;
    private String description;
    private float weight;
    private float length;
    private float height;
    private float width;

    @OneToOne
    @JoinColumn(name = "product_id")
    @MapsId
    private product product;
}

Product 类代码 #

@Getter
@Setter
@Entity
public class product {

    @Id @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Integer id;

    private String name;
    private float price;

    @OneToOne(mappedBy = "product", cascade = CascadeType.ALL)
    @PrimaryKeyJoinColumn
    private ProductDetail detail;

    public product() { }

    public product(String name, float price) {
        super();
        this.name = name;
        this.price = price;
    }
}

问题根源分析 #

1. 实体类命名不符合规范：product类采用小写开头的命名（违反Java大驼峰命名约定），ORM框架在映射数据库结构时可能出现识别偏差，影响约束生成逻辑。
2. 冗余注解导致配置冲突：Product类的detail字段同时使用@OneToOne(mappedBy = "product")和@PrimaryKeyJoinColumn。mappedBy已指定关联由ProductDetail维护，@PrimaryKeyJoinColumn属于冗余配置，会干扰JPA生成正确的数据库约束。
3. 数据库缺少唯一约束：一对一关联的核心要求是外键字段必须带有UNIQUE约束。当前配置下，JPA没有为product_id字段生成正确的唯一约束逻辑，MySQL反向工程会根据字段是否有唯一约束判断关联类型，无唯一约束的外键会被识别为一对多。

修正方案 #

1. 统一实体类命名：将product类名改为Product，同时修正ProductDetail中的关联字段类型：

// ProductDetail类中修正关联字段
@OneToOne
@JoinColumn(name = "product_id")
@MapsId
private Product product; // 改为大写Product

2. 移除冗余注解：删除Product类中detail字段的@PrimaryKeyJoinColumn注解：

// Product类中修正关联配置
@OneToOne(mappedBy = "product", cascade = CascadeType.ALL)
private ProductDetail detail;

3. 确认唯一约束生成：修正后，ProductDetail的product_id作为主键（天然具备唯一性），同时作为关联Product的外键，JPA会正确生成一对一关联的数据库约束，此时MySQL反向工程就能识别为一对一关系。

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