使用 `@onetoone(mappedby = "card")` 表示该关系由 `employee.card` 字段单向维护，hibernate 将在 `employee_data` 表中自动创建 `card_id` 外键列，而 `access_card` 表不会新增 `owner_id` —— 这是双向一对一关系的正确行为，而非错误。
在 JPA 中，mappedBy 的核心语义是声明当前关系为“被映射方”（inverse side），即该端不负责数据库外键的物理存储，而是将关系的持久化责任完全委托给另一端（owning side）。你的代码中：
- Employee.card 是 owning side（拥有方）：未标注 mappedBy，因此 Hibernate 默认在 EMPLOYEE_DATA 表中生成 card_id 列；
- AccessCard.owner 是 inverse side（被映射方）：通过 @OneToOne(mappedBy = "card") 明确声明其关系由 Employee.card 维护，因此 不会生成任何新列 —— 这完全符合 JPA 规范。
✅ 正确的双向 @OneToOne 配置如下（关键点已加注）：
// Employee.java — owning side（必须）
@Entity
@Table(name = "EMPLOYEE_DATA")
public class Employee {
@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE)
private int id;
// ... 其他字段
@OneToOne(cascade = CascadeType.ALL, orphanRemoval = true) // 推荐显式 cascade
@JoinColumn(name = "card_id") // 可选：显式指定外键列名（默认为 "card_id"）
private AccessCard card;
// getter/setter
}// AccessCard.java — inverse side（必须用 mappedBy）
@Entity
@Table(name = "ACCESS_CARD")
public class AccessCard {
@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE)
private int id;
// ... 其他字段
@OneToOne(mappedBy = "card", optional = false) // optional=false 表示 owner 必须存在（非空约束）
private Employee owner;
// getter/setter
}? 验证生成的 DDL（以 H2 为例）：
Intelligent search for agents. Multi-source retrieval with confidence scoring - web, academic, and Tavily in one unified API
下载
智能代理搜索。多源检索置信度评分 - 统一API整合网络、学术和Tavily搜索。
CREATE TABLE EMPLOYEE_DATA (
id INTEGER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
age INTEGER,
card_id INTEGER, -- ✅ 外键在此处
dob DATE,
EMPLOYEE_NAME VARCHAR(255),
ssn VARCHAR(9) UNIQUE NOT NULL,
type VARCHAR(255),
CONSTRAINT FK_EMPLOYEE_CARD FOREIGN KEY (card_id) REFERENCES ACCESS_CARD(id)
);
CREATE TABLE ACCESS_CARD (
id INTEGER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
firmwareVersion VARCHAR(255),
isActive BOOLEAN,
issueDate DATE
);⚠️ 常见误区与注意事项：
- 不要在两端都加 @JoinColumn：这会导致 Hibernate 认为存在两个独立关系，引发 org.hibernate.AnnotationException。
- 级联操作需谨慎：若在 Employee.card 上配置 CascadeType.PERSIST，保存 Employee 时会自动持久化关联的 AccessCard；但 AccessCard.owner 因为是 inverse side，不会触发级联。
- optional = false 很重要：在 AccessCard.owner 上设置可避免 owner_id IS NULL 的歧义（尽管本例中不生成该列，但语义上强调非空依赖）。
-
双向关系需手动同步：JPA 不自动维护 Java 对象引用一致性。务必在业务代码中双向赋值：
employee.setCard(card); card.setOwner(employee); // 缺少此行可能导致内存状态不一致！
? 总结：mappedBy 不是“失效开关”，而是 JPA 关系所有权的声明机制。当你看到 card_id 出现在 EMPLOYEE_DATA 表且 ACCESS_CARD 表无新增列时——恭喜，你的双向一对一配置完全正确。真正需要警惕的，是忘记在 Java 层同步双方引用，或误在 inverse side 添加 @JoinColumn 导致映射冲突。
