@OneToOne注解关联继承TABLE_PER_CLASS父类的实体时外键异常问题

问题根因 #

1. TABLE_PER_CLASS继承策略的特性限制：该策略下抽象父类Human不会生成对应数据库表，所有父类定义的字段（包括主键human_id）会直接冗余生成到每个子类对应的表中。JPA在处理跨继承的关联时，默认会优先尝试匹配父类的主键定义，而非子类表的实际列，导致外键生成逻辑异常。
2. 部分JPA实现（如Hibernate）对TABLE_PER_CLASS策略下的跨实体外键关联兼容度较低，当关联实体的主键继承自抽象父类时，仅指定referencedColumnName无法触发正确的外键生成逻辑。
3. 双向@OneToOne关联的维护逻辑缺失：你在User类中通过mappedBy = "user"指定关联关系由CollectionOfContactMethods的user字段维护，如果保存实体时没有主动给CollectionOfContactMethods的user属性赋值，JPA也不会自动维护外键关联。

解决方案 #

方案1（改动最小，推荐） #

修改CollectionOfContactMethods的关联配置，显式声明外键约束定义，强制JPA生成符合预期的外键：

@OneToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "ext_human_id", 
            referencedColumnName = "human_id",
            foreignKey = @ForeignKey(name = "fk_collection_contact_user_id",
                                    foreignKeyDefinition = "FOREIGN KEY (ext_human_id) REFERENCES end_user(human_id)"))
private User user;

方案2（适配规范，推荐长期使用） #

调整继承策略为InheritanceType.JOINED，该策略完全符合JPA关联规范，外键会自动正确生成：

@Entity(name = "Human")
@Inheritance(strategy = InheritanceType.JOINED)
public abstract class Human {
    // 原有代码保持不变
}

该策略下父类Human会生成独立表存储公共字段，子类User对应的end_user表仅存储子类特有字段，主键关联父类Human的human_id，关联逻辑更清晰。

补充必改配置 #

保存User实体时必须主动设置双向关联关系，否则外键字段会为空：

// 保存实体示例逻辑
User user = new User();
CollectionOfContactMethods contact = new CollectionOfContactMethods();
contact.setUser(user); // 必须显式设置关联
user.setContactNumbers(contact);
userService.save(user);

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