Spring Boot+Hibernate/JPA中Country与City的@ManyToOne关联配置问题

原有配置的核心错误点 #

• 初版单向配置缺陷：Country端使用@OneToMany搭配@JoinColumn(updatable=false, insertable=false)实现单向外键映射，未在City实体配置对应@ManyToOne关联，导致City侧的ORM映射完全感知不到外键字段，查询城市时无法拉取所属国家数据。
• 第二次调整后的报错根因：
  1. 关联加载策略与事务边界不匹配：JPA默认策略为@ManyToOne即时加载、@OneToMany懒加载，查询全量国家时，关联的城市列表为脱离持久化上下文的懒加载代理对象，JSON序列化时触发LazyInitializationException。
  2. 双向关联无限递归：Country实体的城市列表、City实体的国家对象形成双向引用，Jackson序列化时无终止逻辑，触发栈溢出异常。
  3. 映射字段名不匹配：核心规则是mappedBy的取值必须和对方实体中关联属性的字段名完全一致，字段名拼写、大小写不匹配会直接触发ORM映射启动时报错。

满足三项业务要求的最终配置 #

1. 修正后的City实体关联配置 #

@GeneratedValue(strategy = GenerationType.IDENTITY)
@Id
private Long id;

@NotEmpty(message = "Name of country is mandatory.")
@NotNull
@Column(nullable = false, unique = true)
private String nameOfCity;

// ManyToOne关联配置，对齐数据库外键字段名
// 配置即时加载保证查询城市时直接返回所属国家信息
@ManyToOne(fetch = FetchType.EAGER)
@JoinColumn(name = "country_Id", nullable = false)
// 序列化时配合反向端配置，避免无限递归
@JsonBackReference
private CountryModelDao countryId;

2. 修正后的Country实体关联配置 #

@GeneratedValue(strategy = GenerationType.IDENTITY)
@Id
private Long id;

@NotEmpty(message = "Name of country is mandatory.")
@Column(unique = true)
private String nameOfCountry;

@NotBlank(message = "Name of capital is mandatory.")
private String capital;

@Max(value = 17098242L, message = "Maximum value for population = 10000000000")
private Long surface;

private String countryCode;

private String telephoneCode;

// OneToMany关联配置，mappedBy值和City端关联属性名完全对齐
// 配置即时加载保证查询国家时直接返回所有关联城市
@OneToMany(mappedBy = "countryId", fetch = FetchType.EAGER, orphanRemoval = true, cascade = CascadeType.PERSIST)
@JsonManagedReference
private List<CityModelDao> cityModelDao;

关联城市新增的实现逻辑 #

该配置下不需要额外特殊适配，按以下流程操作即可实现关联城市新增：

• 先通过Country仓储查询到目标国家的持久化对象
• 构建新的City实体，给countryId属性赋值上述查询到的国家对象
• 调用City仓储的save方法持久化对象，JPA会自动将当前国家的主键值写入城市表的country_Id外键字段

注意：新增关联时建议双向赋值，除了给City的country属性赋国家对象，也可以按需给国家的城市列表add新的City对象，避免懒加载场景下关联数据缺失。

配置校验注意事项 #

• 不要在配置了mappedBy的@OneToMany反向侧保留@JoinColumn注解，否则JPA会判定外键被重复维护，直接抛出映射冲突异常。
• 如果不需要返回双向嵌套的冗余数据，也可以根据业务需求手动调整序列化策略，比如查询城市时返回国家的核心标识字段，不需要嵌套完整国家对象。
• 确认数据库城市表的country_Id字段和实体配置的外键名完全一致，避免因为字段名大小写、拼写不匹配导致的映射失败。

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