0

0

Jackson @JsonView 字段过滤失效问题的根源与解决方案

心靈之曲

心靈之曲

发布时间:2026-02-17 08:36:01

|

430人浏览过

|

来源于php中文网

原创

Jackson @JsonView 字段过滤失效问题的根源与解决方案

使用 Jackson 的 @JsonView 进行反序列化时,视图本应仅包含标记了对应 View 类的字段,但实际却返回了未匹配视图的字段(值为 null),根本原因在于 ObjectMapper 默认不忽略 null 值——需显式配置 SerializationFeature.WRITE_NULL_MAP_VALUES 和 SerializationFeature.INCLUDE 策略。

使用 jackson 的 @jsonview 进行反序列化时,视图本应仅包含标记了对应 view 类的字段,但实际却返回了未匹配视图的字段(值为 null),根本原因在于 objectmapper 默认不忽略 null 值——需显式配置 `serializationfeature.write_null_map_values` 和 `serializationfeature.include` 策略。

Jackson 的 @JsonView 注解在序列化(serialize)阶段能精准控制字段输出,但在反序列化(deserialize)阶段并不具备字段过滤能力——它仅影响读取时的“视图上下文绑定”,而不会跳过未标注该 View 的字段。因此,当 CreateIpResult 中同时存在 @JsonView(View.CreateIpSuccessResponse.class) 和 @JsonView(View.CreateIpErrorResponse.class) 的字段时,无论使用哪个 View 反序列化,Jackson 都会尝试填充所有字段:未匹配 View 的字段被设为 null,而非被忽略。

这正是你观察到的现象:

  • 使用 View.CreateIpSuccessResponse.class 反序列化时,error 字段虽未标注该 View,但仍被初始化为 null;
  • 使用 View.CreateIpErrorResponse.class 时,partyId 同样被置为 null。

⚠️ 关键误区:@JsonView 不控制反序列化字段的存活性,只影响序列化输出和反序列化时的“类型绑定上下文”(如多态解析),而非字段级排除。

正确解决方案:禁用 null 字段序列化 + 合理设计视图结构

虽然反序列化本身无法跳过字段,但可通过以下组合策略实现预期效果:

✅ 1. 全局配置 ObjectMapper 忽略 null 值(必须)

ObjectMapper mapper = new ObjectMapper();
// 核心配置:序列化时跳过 null 值(影响 toJSONString 输出及响应体)
mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
// 可选增强:反序列化时也忽略未知属性(防污染)
mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);

? 注意:setSerializationInclusion() 仅影响序列化输出(如 writeValueAsString()),但它能确保你最终返回给前端的 JSON 不含 "Error": null 或 "partyid": null ——这正是你示例中期望的干净响应结构。

✅ 2. 视图定义需严格分层,避免交叉污染

当前 CreateIpPResponse 中所有字段都同时标注了两个 View:

360智绘
360智绘

360智脑推出的AI绘画创作与分享平台

下载
@JsonView({View.CreateIpSuccessResponse.class, View.CreateIpErrorResponse.class})
private String status; // ✅ 合理:共用字段

这是正确的。但 CreateIpResult 应仅标注各自专属 View,且确保无冗余继承:

@Data
public class CreateIpResult {
    @JsonProperty("partyid")
    @JsonView(View.CreateIpSuccessResponse.class) // 仅 Success 视图可见
    private String partyId;

    @JsonProperty("Error")
    @JsonView(View.CreateIpErrorResponse.class) // 仅 Error 视图可见
    private String error;
}

✅ 此设计已正确 —— 无需修改。

✅ 3. 反序列化逻辑保持简洁(无需手动 toJSONString)

你当前代码中存在低效且易错的中间序列化步骤:

// ❌ 不推荐:先序列化成字符串,再反序列化(性能差 + null 字段仍存在)
return mapper.readerWithView(View.CreateIpSuccessResponse.class)
    .forType(CreateIpResponse.class)
    .readValue(mapper.writeValueAsString(response));

更优写法(直接从 Map 反序列化,避免字符串中转):

// ✅ 推荐:直接读取 Map,Jackson 自动按 View 绑定字段
ObjectReader reader = mapper.readerWithView(
    responseCode.equals(BigDecimal.valueOf(200)) 
        ? View.CreateIpSuccessResponse.class 
        : View.CreateIpErrorResponse.class
).forType(CreateIpResponse.class);

// 假设 response 是 Map<String, Object>,可直接读取
return reader.readValue(response); // 无需先 writeValueAsString!

✅ 4. 验证效果:最终响应将自动剔除 null 字段

启用 JsonInclude.Include.NON_NULL 后,即使对象内部 error == null,序列化结果中将完全不出现 "Error": null,同理 partyId 在错误场景下也不会输出。你的预期 JSON 将自然达成:

// Success 响应(无 "Error" 字段)
{
  "pResponseCode": 200,
  "pResponse": {
    "Status": "OK",
    "Result": { "partyid": "98493305" },
    "responseCode": "200"
  }
}

总结

  • @JsonView 在反序列化中不跳过字段,只参与类型/属性绑定决策
  • null 字段出现在 JSON 中,是因为 ObjectMapper 默认序列化 null 值;
  • 唯一可靠解法是全局设置 mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL)
  • 配合清晰的 View 分层与直接 Map 反序列化,即可实现语义准确、结构干净的视图化响应。

? 补充提示:若需在反序列化阶段真正“跳过”某些字段(如安全敏感字段),应改用 @JsonIgnore、@JsonAlias 或自定义 JsonDeserializer,而非依赖 @JsonView。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

442

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

544

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

322

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

81

2025.09.10

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

244

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

746

2024.03.01

java多态详细介绍
java多态详细介绍

本专题整合了java多态相关内容,阅读专题下面的文章了解更多详细内容。

22

2025.11.27

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

371

2023.10.18

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

283

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 9.3万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号