JPA一对多关联报错：mappedBy指向目标实体不存在的属性

1. 实体关联配置错误分析 #

错误根源是**@OneToMany的mappedBy属性值拼写错误**：

• 在NPMLeague类中，@OneToMany(mappedBy = "npmleague")里的npmleague是全小写的L，但NPMStadium类中对应的关联属性是npmLeague（驼峰命名，L大写）。
• JPA会根据mappedBy的值去目标实体查找对应属性，拼写不匹配就会抛出找不到属性的错误。

修正后的NPMLeague代码： #

@Entity
@Data
@AllArgsConstructor
@NoArgsConstructor
@Table(name = "npm_leagues")
public class NPMLeague implements Serializable {
    @Id
    @GeneratedValue(strategy= GenerationType.AUTO)
    private Long id;

    // 修正mappedBy的值为npmLeague，和NPMStadium的属性名一致
    @OneToMany(mappedBy = "npmLeague",cascade = CascadeType.ALL)
    List<NPMStadium> npmStadiums;
}

2. Liquibase对关联关系的影响 #

Liquibase是数据库schema版本管理工具，本身不会直接影响JPA实体的关联逻辑，但需要确保Liquibase脚本里的数据库结构和实体配置一致：

• 检查你的Liquibase脚本中，npm_stadiums表是否存在npm_league_id外键列，且该列关联npm_leagues表的id列。
• 如果脚本中的外键列名、关联表和实体的@JoinColumn(name = "npm_league_id")配置一致，就不会有冲突；如果不一致，会导致JPA操作数据库时出现外键约束错误。

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