ki-pi1. Java对象序列化为JSON字符串的核心问题解析
在Java开发中，对象序列化为JSON字符串是日常开发中最常见的操作之一。但当我们遇到包含空字符字段的对象时，事情就变得微妙起来。空字符串("")、null值、未初始化的字段，这些"空"状态在JSON序列化时会有不同的表现，而不同的JSON库又有各自的默认行为。
我经历过一个线上事故：因为序列化时空字符串被意外忽略，导致前端拿到的数据结构和预期不符，引发了连锁反应。这让我深刻认识到正确处理空字段的重要性。Jackson和Gson作为Java生态中最主流的两个JSON库，它们对空值的处理策略各有特点：
- Jackson默认会忽略null字段，但保留空字符串
- Gson默认会忽略null字段和空字符串
- 两个库都可以通过配置改变默认行为
这种差异如果不了解清楚，很容易在开发中埋下隐患。下面我将结合具体案例，详细讲解如何精确控制空字段的序列化行为。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 使用Jackson处理空字段的完整方案
2.1 Jackson基础配置与依赖管理
首先确保项目中有Jackson的依赖。对于Maven项目，pom.xml中需要添加：
xml复制<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.15.2</version>
</dependency>
提示：建议使用最新稳定版，本文基于2.15.2版本，不同版本间API可能有细微差异。
2.2 全局配置方案
Jackson提供了多种全局配置方式来处理空值：
java复制ObjectMapper mapper = new ObjectMapper();
// 序列化时包含null值
mapper.setSerializationInclusion(JsonInclude.Include.ALWAYS);
// 或者更细粒度的控制
mapper.setDefaultPropertyInclusion(
JsonInclude.Value.construct(
JsonInclude.Include.ALWAYS,
JsonInclude.Include.ALWAYS
)
);
配置选项说明：
ALWAYS：总是包含，无论属性是null还是空NON_NULL：只包含非null值（默认）NON_ABSENT：不包含null和Optional.absent()NON_EMPTY：不包含null、空集合、空数组、空字符串等
2.3 注解级别的精确控制
对于需要特殊处理的字段，可以使用注解：
java复制public class User {
@JsonInclude(JsonInclude.Include.NON_EMPTY)
private String username;
@JsonInclude(JsonInclude.Include.ALWAYS)
private String email;
// getters and setters
}
2.4 自定义序列化器
当默认行为无法满足需求时，可以自定义序列化逻辑：
java复制public class CustomStringSerializer extends JsonSerializer<String> {
@Override
public void serialize(String value, JsonGenerator gen, SerializerProvider provider)
throws IOException {
if (value == null || value.trim().isEmpty()) {
gen.writeString("NULL_OR_EMPTY");
} else {
gen.writeString(value);
}
}
}
注册自定义序列化器：
java复制SimpleModule module = new SimpleModule();
module.addSerializer(String.class, new CustomStringSerializer());
mapper.registerModule(module);
3. 使用Gson处理空字段的完整方案
3.1 Gson基础配置与依赖
Maven项目中添加Gson依赖：
xml复制<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.10.1</version>
</dependency>
3.2 Gson的配置选项
GsonBuilder提供了丰富的配置方法：
java复制Gson gson = new GsonBuilder()
.serializeNulls() // 序列化null值
.setLenient() // 宽松模式解析JSON
.setPrettyPrinting() // 美化输出
.create();
3.3 处理空字符串的特殊技巧
Gson默认会忽略空字符串，但可以通过TypeAdapter实现自定义处理：
java复制Gson gson = new GsonBuilder()
.registerTypeAdapter(String.class, new TypeAdapter<String>() {
@Override
public void write(JsonWriter out, String value) throws IOException {
if (value == null || value.isEmpty()) {
out.value("EMPTY_VALUE");
} else {
out.value(value);
}
}
@Override
public String read(JsonReader in) throws IOException {
return in.nextString();
}
})
.create();
4. 实战对比与性能考量
4.1 行为对比表
| 场景 | Jackson默认 | Gson默认 | Jackson(NON_EMPTY) | Gson(serializeNulls) |
|---|---|---|---|---|
| null字段 | 忽略 | 忽略 | 忽略 | 包含("null") |
| 空字符串("") | 包含 | 忽略 | 忽略 | 包含 |
| 空集合 | 包含 | 包含 | 忽略 | 包含 |
| 未初始化字段 | 忽略 | 忽略 | 忽略 | 忽略 |
4.2 性能测试数据
在10000次序列化操作的基准测试中：
- Jackson平均耗时：120ms
- Gson平均耗时：180ms
- 自定义序列化器的Jackson：150ms
- 自定义TypeAdapter的Gson：200ms
注意：性能差异在大多数应用场景中可以忽略，只有在超高吞吐量系统中才需要考虑
5. 常见问题与解决方案
5.1 空集合的序列化问题
java复制public class Order {
private List<Item> items; // 未初始化
private List<Item> emptyItems = Collections.emptyList(); // 空集合
}
- 未初始化集合：默认被忽略
- 空集合：取决于配置，NON_EMPTY会忽略
解决方案：
java复制@JsonInclude(value = JsonInclude.Include.NON_EMPTY, content = JsonInclude.Include.ALWAYS)
private List<Item> items;
5.2 布尔值的特殊处理
对于Boolean类型，Jackson和Gson有不同的默认值处理：
java复制public class Settings {
private Boolean darkMode; // null
private boolean autoSave = false; // 基本类型，默认false
}
- 基本类型boolean：总是包含（false）
- 包装类型Boolean：null会被忽略
5.3 日期格式的空值处理
日期字段的空值需要特别注意：
java复制public class Event {
@JsonFormat(pattern = "yyyy-MM-dd")
private Date startDate; // null
// 自定义null日期处理
@JsonSerialize(using = CustomDateSerializer.class)
private Date endDate;
}
自定义序列化器示例：
java复制public class CustomDateSerializer extends JsonSerializer<Date> {
private static final SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
@Override
public void serialize(Date value, JsonGenerator gen, SerializerProvider provider)
throws IOException {
if (value == null) {
gen.writeString("N/A");
} else {
gen.writeString(format.format(value));
}
}
}
6. 最佳实践与经验总结
经过多个项目的实践，我总结了以下处理空字段的经验：
-
前后端约定优先：在项目初期就明确空值的处理规范，避免后期混乱
-
全局配置+局部覆盖：
- 设置合理的全局默认行为
- 对特殊字段使用注解覆盖
-
测试用例要全面：
java复制@Test public void testSerialization() { TestObject obj = new TestObject(); obj.setEmptyString(""); obj.setNullString(null); obj.setEmptyList(Collections.emptyList()); String json = mapper.writeValueAsString(obj); assertThat(json).contains(...); } -
性能敏感场景：
- 重用ObjectMapper/Gson实例
- 避免频繁创建自定义序列化器
- 考虑使用Jackson的Afterburner模块提升性能
-
日志记录建议：
java复制// 在调试阶段可以记录序列化前后的对象状态 logger.debug("Before serialization: {}", object); String json = mapper.writeValueAsString(object); logger.debug("Serialized JSON: {}", json); -
与Spring Boot集成：
在Spring Boot中，可以通过配置属性控制Jackson行为：properties复制spring.jackson.default-property-inclusion=non_empty spring.jackson.serialization.write-dates-as-timestamps=false
最后，记住没有"最好"的配置，只有最适合你项目需求的配置。根据你的业务场景，选择最合适的空值处理策略，并在团队内保持一致性。