Hibernate双向OneToOne关联报mappedBy错误与未知实体异常排查

两个接连出现的异常是两层配置问题叠加导致的，并非你的注解写法和网上示例有本质差异，具体原因和修正方案如下：

• 第一层问题：Car类未被Hibernate识别为合法实体
  删掉mappedBy后抛出@OneToOne or @ManyToOne on hiber.model.User.car references an unknown entity: hiber.model.Car错误，本质是Hibernate根本没把Car类纳入实体管理范围，常见触发原因有两个：
  1. 实体扫描路径遗漏：不管是传统Hibernate的hibernate.cfg.xml配置、Spring JPA的实体扫描配置，都需要确保扫描范围覆盖hiber.model包下的全部类。很多项目配置只手动登记了User类，漏了Car类的映射声明，就会触发该错误。
  2. Car类不满足实体基础要求：Hibernate强制要求实体类提供无参构造器。你给出的Car类代码只标注了有getter/setter，如果类里只写了带参构造没有补无参构造，就算加了@Entity注解，Hibernate也不会把它识别为合法实体。
• 第二层问题：关联属性的反射读取失败
  当Car被正常识别为实体后，依然抛出Unknown mappedBy in: hiber.model.User.car, referenced property unknown: hiber.model.Car.user错误，说明Hibernate无法在Car类里找到名为user的关联属性，常见触发原因：
  1. 字段访问权限问题：如果Car类的user字段没有搭配可被反射读取的getter方法，或是字段被错误修饰为静态、final类型，Hibernate就会判定该属性不存在。
  2. 外键列配置冲突：你在Car的关联字段上写了@JoinColumn(name = "id")，但Car自身的主键是String类型的model，car表结构里根本没有名为id的列，会导致实体映射在初始化阶段出现解析异常，间接造成关联属性读取失败。

正确的配置修正步骤 #

• 给User和Car类都补充无参构造器，满足Hibernate的实例化要求；
• 检查持久层配置，确保两个实体类都被纳入扫描/映射列表，没有漏登记；
• 把Car类上的@JoinColumn(name = "id")修改为@JoinColumn(name = "user_id")，和User表的主键类型（Long）保持匹配，避免列名和自身主键冲突；
• 确认Car类的user字段有对应的getter/setter，能被Hibernate的反射机制正常读取。

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