Hibernate新增passportId报DuplicateMappingException问题咨询

这个异常本质是Hibernate的ORM映射校验不通过，核心冲突点是：student表里的同一个物理列passport_id，被两个不同的实体属性同时映射，且两个属性声明的逻辑列名不一致，Hibernate无法判定该列的读写归属，直接抛错。
具体映射冲突的产生逻辑：

• 实体里的@OneToOne private Passport passport关联属性，Hibernate默认会在当前student表生成指向Passport表主键的外键列，按照默认驼峰转下划线的命名规则，这个外键的物理列名就是passport_id，对应的逻辑列名是passport_id。
• 你手动新增的基础属性private Integer passportId，走同样的命名规则驼峰转下划线后，映射的物理列名同样是passport_id，但这个属性自身的逻辑列名是passportId。
  Hibernate的核心映射规则要求：单张表内一个物理列只能对应唯一的逻辑列名，且只能有一个属性掌握该列的写入控制权，两个属性同时争抢同一个物理列的映射，自然就触发了重复映射异常。

你加的@Column(name = "passport_id", insertable = false, updatable = false)注解刚好从两个维度解决了上述冲突：

• 第一，name = "passport_id"显式指定passportId属性的逻辑列名就是passport_id，和OneToOne关联外键的逻辑列名完全对齐，先解决了「同一物理列对应多个逻辑名」的核心冲突。
• 第二，insertable = false, updatable = false相当于给Hibernate明确声明：这个passportId属性只是只读字段，不参与insert、update语句的生成，passport_id列的所有写操作完全交给@OneToOne关联的passport属性对应的外键配置来处理，不会出现两个属性同时修改同一列的逻辑矛盾。
  如果只配置name对齐但不设置insertable = false, updatable = false，Hibernate依然会检测到两个属性都拥有该列的写入权限，还是会抛出映射冲突，两个配置缺一不可。
  这种写法本质是把手动加的passportId做成了关联外键的只读快捷字段——你可以直接通过这个属性拿到关联Passport的id，不用每次写student.getPassport().getId()级联取值，同时又完全不破坏原有OneToOne的关联映射规则，自然不会再抛异常。

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