自定义JsonInclude过滤器遇Spotbugs EQ_CHECK_FOR_OPERAND_NOT_COMPATIBLE_WITH_THIS错误求解

你的实现完全符合Jackson的官方约定，但Spotbugs抛出的EQ_CHECK_FOR_OPERAND_NOT_COMPATIBLE_WITH_THIS错误，是因为它遵循Java equals方法的常规契约（要求比较同类型对象实例），而Jackson的自定义过滤器用法打破了这个常规——它会把待序列化的属性值传入过滤器的equals方法，而非过滤器的同类型实例，因此触发了误报。

以下是几种可行的解决方法：

方法一：添加Spotbugs忽略注解（推荐） #

直接在IgnoreTrueFilter类或其equals方法上添加@SuppressFBWarnings注解，屏蔽该误报规则：

import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;

public class Car {
  @JsonInclude(value = JsonInclude.Include.CUSTOM, valueFilter = IgnoreTrueFilter.class)
  private boolean isNew = true;
}

@SuppressFBWarnings("EQ_CHECK_FOR_OPERAND_NOT_COMPATIBLE_WITH_THIS")
public static class IgnoreTrueFilter {
  @Override
  public boolean equals(Object value) {
    if (!(value instanceof Boolean)) {
      return true;
    }
    return Boolean.TRUE.equals(value);
  }
}

注意需要确保项目中引入了Spotbugs的注解依赖（比如findbugs-annotations）。

方法二：改用Jackson的其他过滤方式 #

如果不想使用注解屏蔽，可以改用Jackson的原生过滤规则，比如：

• 若isNew的默认值是true，直接用@JsonInclude(JsonInclude.Include.NON_DEFAULT)，这样只有当isNew为false时才会被序列化（因为false不是默认值）。
• 或者自定义JsonSerializer，在序列化逻辑中手动判断是否输出该属性，但这种方式代码量会增加，不如原实现直观。

补充说明 #

Jackson的自定义过滤器确实要求equals方法接收属性值作为参数，这是官方明确的特殊用法，因此Spotbugs的报错属于误判，使用注解屏蔽是最直接且合理的方案。

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