Spring Boot 3.4配置属性级联验证报错：Default value must not be null

问题重现 #

• Spring Boot 3.3版本中，配置类通过@Validated实现级联验证，当配置文件中keyword为空时，能正常抛出明确的验证错误提示。
• 升级到Spring Boot 3.4后，必须为泛型参数添加@Valid才能触发级联验证，但添加后抛出异常：

  java.lang.IllegalStateException: Default value must not be null
  

原因分析 #

Spring Boot 3.4升级了Hibernate Validator等核心依赖，对配置类的验证逻辑做了更严格的处理：

• 当在泛型参数中添加@Valid后，验证框架会对parameters字段的默认值进行校验。
• 你的代码中@Builder.Default修饰的parameters字段未显式赋值，默认值为null，不符合验证规则，从而触发异常。

解决方案 #

为parameters字段显式设置空Map作为默认值，同时保留泛型内的@Valid注解，修改后的代码如下：

@Data
@ConfigurationProperties
@Validated
@NoArgsConstructor
@AllArgsConstructor
@Builder(setterPrefix = "with")
@JsonIgnoreProperties(ignoreUnknown = true)
public class MyConfigConfiguration {
    @Builder.Default
    private Map<String, List<@Valid ParameterConfiguration>> parameters = new HashMap<>();
}

验证效果 #

修改完成后重新启动应用：

• 当配置文件中keyword为空时，会恢复Spring Boot 3.3版本时的明确验证错误提示。
• 不再抛出Default value must not be null异常，级联验证功能正常生效。

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