添加Lombok @Builder后Spring配置加载失效且无报错，原因何在？

这是Spring Boot配置绑定的预期行为，并非Bug，官方文档有明确说明。

核心原因 #

1. Spring Boot的@ConfigurationProperties绑定机制默认依赖JavaBean规范：目标类需要提供公共无参构造函数，通过Setter方法完成属性注入；或者使用@ConstructorBinding配合全参构造函数实现构造函数绑定。
2. 给ExportClientConfig添加@Builder注解后，Lombok会自动生成私有无参构造函数（如果类没有显式构造函数），同时生成Builder逻辑。但Spring Boot的配置绑定组件无法识别Lombok的Builder，也无法通过私有构造函数实例化对象，最终导致clientConfigurations的条目绑定失败。
3. 无报错或警告是因为Spring Boot在处理嵌套配置（如Map中的对象）时采用容错策略：无法实例化对象时会静默跳过该条目绑定，避免局部配置问题导致整个应用启动失败。

官方文档说明 #

Spring Boot官方文档中关于@ConfigurationProperties的章节明确指出：

用于绑定的类需要符合JavaBean规范，或者使用@ConstructorBinding注解配合构造函数实现绑定。当使用Lombok的@Builder时，必须确保类提供了Spring能识别的实例化方式——要么生成公共无参构造函数，要么结合构造函数绑定注解。

解决方案 #

有两种可行的修复方式：

方式1：保留Builder同时添加无参构造函数 #

给ExportClientConfig添加@NoArgsConstructor和@AllArgsConstructor，让Lombok生成公共无参构造函数，确保Spring可以通过Setter注入配置：

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class ExportClientConfig {
    private String code;
    private Integer center;
    private String payCode;
}

方式2：使用构造函数绑定模式 #

如果你的Spring Boot版本在2.2及以上，可以用@ConstructorBinding配合全参构造函数，让Spring通过构造函数实例化对象：

@Data
@Builder
@AllArgsConstructor
@ConstructorBinding
public class ExportClientConfig {
    private String code;
    private Integer center;
    private String payCode;
}

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