1. 现象与原因
1.1 Jackson 反序列化中的默认值误区
在把 JSON 转换为 Java 对象时，布尔原始类型(boolean) 的默认值是 false，这会导致如果 JSON 中没有该字段，反序列化后的对象该字段仍然显示为 false，从而与期望（字段未提供的状态）混淆。这是由 Java 基本类型默认初始化规则决定的，与 Lombok 本身无关，但在 Lombok + Jackson 场景中会被放大。这也是为什么会出现“默认值问题”的根本原因之一。
另外，如果你使用 Lombok 的 @Builder 与 Jackson 的 @JsonDeserialize 构造对象，默认的构建路径以及字段映射可能无法区分“字段未提供”与“字段显式设为 false”，从而出现看似“默认值被填充”的现象。
1.2 Lombok Builder 与 Jackson 的兼容性要点
默认情况下 Jackson 的 Builder 前缀为 with，但 Lombok 的 Builder 方法名称通常为字段名如 active(boolean)，两者不匹配会导致 Jackson 无法正确调用构建方法，进而回填默认值或忽略某些字段的设置。这类不匹配是常见的导致“默认值被错误填充”的原因。
解决这类问题的关键是让 Jackson 知道如何使用 Lombok 生成的 Builder；常见做法是对 Builder 使用 @JsonPOJOBuilder(withPrefix = "")，或者不要使用 Builder，改为普通的无参构造并用 Setter 赋值。
2. 如何排查问题
2.1 确认使用路径和注解配置
首先确认你的类是否通过 @JsonDeserialize(builder = …) 指定了 Builder，以及 Lombok 是否 @Builder 生成了相应的 Builder。如果两者路径不匹配，Jackson 可能无法正确设置字段，导致底层字段未被赋值，保持默认值。
同时检查 布尔字段是 primitive boolean 还是包装类型 Boolean，这会直接影响缺失字段的处理逻辑。对缺失字段你更希望得到“未设置”的语义，应该优先考虑包装类型。
2.2 复现与对比测试
通过两份对比 JSON 进行小范围测试：{} 与 {"active":false}；与布尔包装类型对比结果是否一致。若结果不同，基本能够定位为构造路径或映射策略的问题。
在调试过程中，打开 Jackson 的调试日志或使用单元测试打印反序列化后的对象字段值，能直观看到未设值的字段何时被赋值为默认值。
3. 解决方案与最佳实践
3.1 使用包装类型 Boolean 来表达“缺失”语义
将布尔字段从 primitive boolean 转为包装类型 Boolean，可以区分 缺失 与 显式设为 true/false，从而避免因默认值导致的逻辑错误。
import lombok.Builder;
import lombok.Getter;
import com.fasterxml.jackson.databind.annotation.JsonDeserialize;@Getter
@Builder
@JsonDeserialize(builder = User.UserBuilder.class)
public class User {private Boolean active; // 使用包装类型，缺失时为 null
}
在对应的业务逻辑中，要考虑 null 的情况，例如：active == null 代表未指定，true/false 代表明确指定。
3.2 配置 Jackson Builder 以正确对齐 Lombok
如果你选择用 Lombok 的 @Builder，并希望 Jackson 能正确反序列化，请确保 Jackson 的 Builder 前缀设置为无前缀，以匹配 Lombok 的生成方法名：
import com.fasterxml.jackson.databind.annotation.JsonPOJOBuilder;@Getter
@Builder
@JsonDeserialize(builder = User.UserBuilder.class)
@JsonPOJOBuilder(withPrefix = "")
public class User {private Boolean active;
}
这样配置后，序列化时的 JSON {"active": true} 就会正确映射到其 Builder 的 active(Boolean active) 方法，最终得到正确的字段值。
3.3 如果坚持使用 primitive boolean，补充标记字段或默认值策略
若业务必须使用 primitive boolean，可以采取下列策略来降低误差：添加辅助字段表示是否明确设置，或者在反序列化后通过校验确保关键字段的状态符合期望。
public class User {private boolean active;// 辅助字段，指示是否明确设置了 activeprivate boolean activeSpecified;
}
不过这会引入额外的代码和维护成本，通常不如替换为 Boolean 更简单直接。
3.4 其他实用优化
启用 Jackson 的空值策略，让缺失字段保持 null 而不是使用默认值，可以结合 JsonInclude 与 JsonSetter 的设置来实现；例如：
import com.fasterxml.jackson.annotation.JsonInclude;
import com.fasterxml.jackson.annotation.JsonSetter;
import com.fasterxml.jackson.annotation.Nulls;@JsonInclude(JsonInclude.Include.ALWAYS)
public class User {@JsonSetter(nulls = Nulls.SKIP)private Boolean active;
}
这类配置有助于在应用层面区分“字段未提供”与“字段提供了 null/false”的场景。
