本文详解 @JsonIgnore 无效的根本原因：混用已废弃的 Codehaus Jackson（org.codehaus.jackson）与新版 FasterXML Jackson（com.fasterxml.jackson），导致注解与 ObjectMapper 不兼容，并提供完整的迁移步骤与代码修正。
本文详解 `@jsonignore` 无效的根本原因：混用已废弃的 codehaus jackson（`org.codehaus.jackson`）与新版 fasterxml jackson（`com.fasterxml.jackson`），导致注解与 objectmapper 不兼容，并提供完整的迁移步骤与代码修正。
在使用 Jackson 进行 JSON 序列化时，若为字段添加了 @JsonIgnore 却发现该字段仍出现在最终 JSON 中，问题极大概率并非注解写法错误，而是依赖版本混用导致的注解失效。您当前的项目中同时引入了两个完全独立、不兼容的 Jackson 生态：
- org.codehaus.jackson（Codehaus Jackson，2013 年前主流，已停止维护）
- com.fasterxml.jackson.*（FasterXML Jackson，当前官方标准，持续更新）
关键矛盾在于：
✅ @JsonIgnore 来自 com.fasterxml.jackson.annotation.JsonIgnore（您代码中正确引入）
❌ 但 ObjectMapper 却来自 org.codehaus.jackson.map.ObjectMapper（旧版），它根本无法识别 com.fasterxml 包下的任何注解——二者注解类名虽同，但包路径不同、字节码隔离、无任何继承或兼容关系。
✅ 正确迁移步骤
1. 清理并替换 Maven 依赖
移除全部 org.codehaus.jackson 相关依赖（尤其是 jackson-xc），仅保留 FasterXML 官方组件：
<dependencies>
<!-- 移除以下过时依赖 -->
<!--
<dependency>
<groupId>org.codehaus.jackson</groupId>
<artifactId>jackson-xc</artifactId>
<version>1.9.12</version>
</dependency>
-->
<!-- 替换为现代等效模块（如需 JAXB 支持） -->
<dependency>
<groupId>com.fasterxml.jackson.module</groupId>
<artifactId>jackson-module-jaxb-annotations</artifactId>
<version>2.14.2</version>
</dependency>
<!-- 核心依赖（保持不变） -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>2.14.2</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-annotations</artifactId>
<version>2.14.2</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.14.2</version> <!-- ⚠️ 必须显式添加！ -->
</dependency>
</dependencies>? 注意：jackson-databind 是 ObjectMapper 所在模块，必须声明，否则编译失败。
2. 更新 Java 导入与序列化代码
修改 FormatAlerts 类中的导入和调用方式：
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
// ❌ 错误导入（旧版）
// import org.codehaus.jackson.map.ObjectMapper;
// ✅ 正确导入（新版）
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature; // 可选：用于配置
public class FormatAlerts {
private final List<Message> alerts;
public FormatAlerts(List<Message> alerts) {
this.alerts = alerts;
}
public List<String> formatAlerts() {
List<String> formattedAlerts = new ArrayList<>();
ObjectMapper om = new ObjectMapper();
// 启用缩进输出（替代已废弃的 defaultPrettyPrintingWriter）
om.enable(SerializationFeature.INDENT_OUTPUT);
try {
for (Message m : alerts) {
// ✅ 使用新版 writerWithDefaultPrettyPrinter()
String alert = om.writerWithDefaultPrettyPrinter()
.writeValueAsString(m);
formattedAlerts.add(alert);
}
} catch (Exception e) {
e.printStackTrace();
}
return formattedAlerts;
}
}3. 验证 @JsonIgnore 生效（POJO 示例）
确保您的 MyPOJO 或 Message 类使用的是新版注解：
import com.fasterxml.jackson.annotation.JsonIgnore;
public class Message {
private String title;
@JsonIgnore
private String socialSecurityNumber = "111-11-1111";
// getter/setter...
public String getTitle() { return title; }
public void setTitle(String title) { this.title = title; }
public String getSocialSecurityNumber() { return socialSecurityNumber; }
public void setSocialSecurityNumber(String ssn) { this.socialSecurityNumber = ssn; }
}✅ 序列化后 JSON 将不再包含 socialSecurityNumber 字段。
⚠️ 重要注意事项
- 禁止混合使用两个 Jackson 生态：org.codehaus 和 com.fasterxml 的类不可互换，运行时不会报错，但注解静默失效。
- jackson-databind 是必需依赖：ObjectMapper 位于该模块，缺失将导致 NoClassDefFoundError。
- 检查 IDE 缓存与 Maven 本地仓库：执行 mvn clean compile 并重启 IDE，避免旧版 JAR 被意外加载。
- 若项目曾使用 JAXB 注解（如 @XmlTransient），请配合 jackson-module-jaxb-annotations 并注册模块：
om.registerModule(new JaxbAnnotationModule());
完成上述迁移后，@JsonIgnore 将严格按预期工作——这是 Jackson 2.x 的标准行为，也是当前生产环境唯一推荐方案。
