Java实体类转JSON时如何避免null值变成“null“？

在Java开发中，实体类与JSON的转换是一个非常常见的需求。今天，我们要聊聊一个特别的重要但又常常被忽视的问题：当我们将Java实体类转换为JSON格式时，如何处理那些null值，避免它们在JSON中出现为字符串“null”呢？听起来有点复杂，但其实我们可以通过一些简单的设置和技巧来解决这个问题。

在Java应用中，我们通常使用一些第三方库来完成JSON的转换工作，比如Jackson或者Gson。这些库都各自有优缺点，但基本功能一致。我们关注的核心问题是，当实体类中的字段值为null时，转换成JSON后会怎样？

为什么null值会变成"null"？

当使用这些库进行转换时，默认情况下，如果某个字段的值为null，JSON对象会体现出这个字段，值却是字符串“null”。举个简单的例子：

public class User {private String name;private Integer age;// getters and setters
}

当我们把一个User对象转换为JSON，而此时name为null，age为30，得到的JSON结果可能是这样的：

{"name": null,"age": 30
}

这虽然看起来清晰明了，但在某些情况下，很多API接口会更希望这个字段在JSON中完全不出现，而不是显示为“null”。

使用Jackson时如何处理null值？

如果你选择使用Jackson来转换JSON，可以通过一些配置来控制null值的处理方式。从Jackson的版本2.0开始，提供了一个非常方便的配置项。可以通过ObjectMapper来设置这个行为。在对象转换中，我们可以调用setSerializationInclusion方法来指定我们想要的种类。

以下是个简单的代码示例：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.annotation.JsonInclude;public class Main {public static void main(String[] args) throws Exception {ObjectMapper mapper = new ObjectMapper();// 只序列化非空字段mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);User user = new User();user.setName(null);user.setAge(30);String jsonString = mapper.writeValueAsString(user);System.out.println(jsonString); // 输出: {"age":30}}
}

在这个示例中，我们告诉Jackson只序列化那些不为null的字段。这样，name字段在转换后完全不会被包含，在结果中就自然不存在了。这样的做法不仅提升了数据的清晰度，也使得给前端或外部API传递数据时更加简洁。

使用Gson时处理null值的方法

如果你的项目中使用的是Gson，那么处理方式略有不同。Gson的默认行为是将null值字段序列化为“null”，但是同样可以通过一些配置来改变这一点。我们可以使用GsonBuilder来排除null字段的序列化。

看看下面的示例：

import com.google.gson.Gson;
import com.google.gson.GsonBuilder;public class Main {public static void main(String[] args) {Gson gson = new GsonBuilder().serializeNulls() // 此行应去掉，才能排除null值字段.create();User user = new User();user.setName(null);user.setAge(30);String jsonString = gson.toJson(user);System.out.println(jsonString); // 输出: {"age":30}}
}