本文介绍如何通过 jackson 的 `@jsonignore` 注解或自定义 bodyfilter，在 zalando logbook 中精准过滤响应体中的特定字段，避免敏感数据（如 `fieldtwo`）被记录到日志中。
Zalando Logbook 是一款轻量、高性能的 HTTP 请求/响应日志框架，但其默认行为会完整记录序列化后的响应体（如 JSON 字符串）。若响应对象中包含需脱敏的字段（例如令牌、密码、内部标识等），仅靠 Logbook 自身配置无法直接“选择性忽略 Java 对象字段”——真正的过滤时机发生在序列化阶段，而非日志捕获阶段。
因此，最直接、可靠且符合职责分离原则的方案是：在 JSON 序列化层控制字段可见性。如果你使用的是 Jackson（Spring Boot 默认 JSON 库），只需为待忽略字段添加 @JsonIgnore 注解：
import com.fasterxml.jackson.annotation.JsonIgnore;
class MyResponse {
private String fieldOne;
@JsonIgnore // ✅ Logbook 将记录不含该字段的 JSON
private String fieldTwo;
private String fieldThree;
// 必须提供 getter/setter（Jackson 默认依赖）
public String getFieldOne() { return fieldOne; }
public void setFieldOne(String fieldOne) { this.fieldOne = fieldOne; }
public String getFieldTwo() { return fieldTwo; }
public void setFieldTwo(String fieldTwo) { this.fieldTwo = fieldTwo; }
public String getFieldThree() { return fieldThree; }
public void setFieldThree(String fieldThree) { this.fieldThree = fieldThree; }
}
✅ 效果：当 MyResponse 被 Jackson 序列化为 JSON 并交由 Logbook 记录时，fieldTwo 将完全不出现，日志中仅保留 fieldOne 和 fieldThree。
其他可行方案补充说明
- @JsonInclude(JsonInclude.Include.NON_NULL) + null 赋值：适用于运行时动态决定是否记录（如将 fieldTwo = null），但语义不如 @JsonIgnore 清晰，且可能影响业务逻辑。
- 自定义 BodyFilter（高级用法）：Logbook 提供 BodyFilter 接口用于正则/字符串级过滤（如 bodyFilter(body -> body.replace("\"fieldTwo\":\".*?\"", ""))），但强烈不推荐——它操作的是已序列化的 JSON 字符串，易因格式变化（空格、换行、嵌套结构）导致过滤失败或 JSON 损坏，违背类型安全原则。
- @JsonIgnoreProperties（类级别）：适用于批量忽略，例如 @JsonIgnoreProperties({"fieldTwo", "internalId"})，适合统一策略场景。
注意事项与最佳实践
- @JsonIgnore 仅作用于序列化（Object → JSON），反序列化（JSON → Object）仍可正常赋值（除非额外加 @JsonIgnore 在 setter 或使用 @JsonIgnoreProperties(allowSetters = true)）。
- 确保你的响应对象有标准 getter 方法，Jackson 默认仅序列化 public getter；若使用 Lombok，请添加 @Getter。
- 若项目中混合使用多种序列化库（如 Gson），需改用对应注解（如 Gson 的 @Expose(serialize = false)）。
- 对于无法修改源码的第三方响应类，可考虑使用 Jackson 的 SimpleModule + BeanSerializerModifier 进行运行时定制，但复杂度显著上升，应作为最后选项。
综上，优先采用 @JsonIgnore 是最简洁、稳定、可维护的解决方案——它把字段过滤逻辑内聚在领域模型中，Logbook 仅忠实记录序列化结果，既符合单一职责，也规避了字符串解析的风险。
