Spring Boot初始化数据时Governorate字段为空引发约束验证异常

这不是框架Bug，你的实现存在问题，导致Governorate的name字段反序列化后为null，触发Bean Validation的非空约束。以下是具体原因和修复方案：

核心原因 #

1. 反序列化时Governorate的name未被正确赋值 #

你使用Jackson的ObjectMapper反序列化JSON数据时，由于Lombok注解的配合问题，Governorate实例的name字段未被正确设置：

• Governorate同时使用@NoArgsConstructor和@RequiredArgsConstructor，ObjectMapper可能优先尝试通过构造器实例化对象，但无法正确匹配带name参数的构造器，最终使用无参构造器创建实例。
• 若ObjectMapper未配置为允许访问私有字段或优先调用setter，即使JSON中有name字段，也无法将值赋值给Governorate的name属性，导致其为null。

2. JSON数据结构可能存在问题 #

如果你的countries.json文件中，governorates数组内的对象缺少name字段，或字段名拼写错误（如title、label），也会导致反序列化后Governorate的name为null。

修复方案 #

方案1：调整ObjectMapper配置 #

在CountriesInitializer的preLoad方法中，显式配置ObjectMapper，确保它能正确识别Lombok生成的setter或直接访问私有字段：

ObjectMapper mapper = new ObjectMapper();
// 允许直接访问私有字段，无需依赖setter
mapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY);
// 或者优先使用setter方法赋值
// mapper.setVisibility(PropertyAccessor.SETTER, JsonAutoDetect.Visibility.ANY);

方案2：明确字段映射（可选） #

在Governorate的name字段上添加@JsonProperty注解，明确指定JSON中的字段名，避免因字段名大小写或拼写不一致导致的映射失败：

@Column(nullable = false)
@NotBlank
@Size(max = 50)
@Setter
@NonNull
@JsonProperty("name")
private String name;

方案3：检查并修正JSON数据 #

确认countries.json的结构符合预期，示例正确结构如下：

[
  {
    "isoCode": "EGY",
    "name": "Egypt",
    "governorates": [
      {"name": "Cairo"},
      {"name": "Alexandria"}
    ]
  }
]

方案4：优化JPA关联映射（可选） #

虽然不是当前错误的直接原因，但单向@OneToMany默认会创建中间表，若需通过外键关联，可添加@JoinColumn优化映射，提升性能：

@OneToMany(cascade = { CascadeType.PERSIST, CascadeType.REMOVE })
@EqualsAndHashCode.Exclude
@JoinColumn(name = "country_iso_code") // 指定Governorate表的外键字段
private List<Governorate> governorates = new ArrayList<>();

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