Spring Data JPA @OneToMany配置启动报mappedBy引用未知属性错误

启动抛出的核心校验错误为：mappedBy reference an unknown target entity property: com.wq.v1.domain.model.Docs.cars in com.wq.v1.domain.model.Car.docs
对应代码层面的错配：

• Car实体配置与Docs的一对多关联时，设置的mappedBy值为"cars"
• Docs实体中实际持有外键、关联Car的属性名为car，不存在名为cars的成员属性，Hibernate解析实体映射时无法匹配到对应字段，直接中断启动流程

1. 修正Car实体中docs集合关联的映射参数
   将原代码：

@OneToMany(mappedBy="cars")
@JsonIgnore
private Set<Docs> docs;

修改为：

@OneToMany(mappedBy="car")
@JsonIgnore
private Set<Docs> docs;

2. 同步排查images集合的同类配置问题
   你在Car实体中给images集合配置的mappedBy值同样是"cars"，只要Image实体中关联Car的属性名不是cars，修复完Docs的映射后就会触发同类型的Image关联报错，需要将该值修改为Image实体中实际定义的Car关联属性名，保持两边属性名严格一致。

mappedBy的参数值为大小写敏感的字符串，必须与被关联实体中持有外键的属性名完全匹配：

• 例如Docs类中定义的关联Car的属性是private Car car;，对应mappedBy就必须写"car"，不能简写、加复数或者随意命名
• 后续如果修改了Doc/Image实体中的关联属性名，需要同步更新Car实体中对应的mappedBy值，否则会再次触发同类映射异常

内容的提问来源于stack exchange，提问作者Mohamad J. M