Jackson注解干扰JSON输出问题及简洁JSON生成方案咨询

我在使用jackson-databind 2.8.9版本搭配ObjectMapper做JSON序列化时遇到了麻烦：实体类上的JPA和JAXB注解干扰了Jackson的序列化逻辑，生成的JSON里莫名出现了integral、string、valueType和chars这些实体类中从未定义过的字段。我的基础实体类代码片段如下：

@MappedSuperclass
@XmlRootElement
@XmlAccessorType(XmlAccessType.FIELD)
public abstract class BaseEntity implements Serializable {
    private static final long serialVersionUID = 5234608700757438450L;
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    // 其他基础字段定义...
}

想请教如何解决这个问题，生成只包含实体类定义字段的简洁JSON。

针对你遇到的问题，核心原因是Jackson默认会解析JAXB注解，且旧版本（2.8.9）可能存在JPA/JAXB注解兼容的bug，导致序列化逻辑异常。这里提供几种可行的解决办法：

1. 禁用Jackson对JAXB注解的支持 #

既然你的实体类混用了JAXB注解，而Jackson默认会启用JAXB注解模块处理这些注解，这很可能是多余字段生成的根源。可以直接在ObjectMapper中关闭该模块：

ObjectMapper objectMapper = new ObjectMapper();
// 关闭JAXB注解解析，让Jackson只使用自身的注解规则
objectMapper.disable(MapperFeature.USE_JAXB_ANNOTATIONS);

2. 显式指定Jackson的字段访问策略 #

如果需要保留JAXB注解的其他用途（比如XML序列化），可以单独给Jackson设置严格的字段访问策略，确保只序列化实体类中显式定义的字段：

ObjectMapper objectMapper = new ObjectMapper();
// 设置仅识别实体类的字段，忽略getter/setter带来的额外属性
objectMapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY);
objectMapper.setVisibility(PropertyAccessor.GETTER, JsonAutoDetect.Visibility.NONE);
objectMapper.setVisibility(PropertyAccessor.SETTER, JsonAutoDetect.Visibility.NONE);

3. 用Jackson注解直接过滤多余字段 #

在BaseEntity类上添加Jackson的@JsonIgnoreProperties注解，明确指定要忽略的多余字段，快速解决当前问题：

@MappedSuperclass
@XmlRootElement
@XmlAccessorType(XmlAccessType.FIELD)
@JsonIgnoreProperties({"integral", "string", "valueType", "chars"})
public abstract class BaseEntity implements Serializable {
    // 类内容保持不变...
}

4. 升级Jackson版本（可选） #

2.8.9是比较老旧的版本，存在不少已知的注解兼容问题。如果项目依赖允许，建议升级到2.13.x及以上的稳定版本，新版本对JPA和JAXB注解的兼容性更好，大概率能直接避免这类异常。

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