1. 为什么空字符串会让JSON反序列化崩溃?
最近在重构一个老项目时,我遇到了一个典型的JSON反序列化问题。原先的实体类字段定义为private String projectTypeId,前端传空字符串("")完全没问题。但当业务需求变更,需要改为集合类型private List<String> projectTypeId后,问题就来了——前端传空字符串会导致系统直接抛出异常。
这个问题的本质在于类型系统的严格性。Java的集合框架和JSON解析器对空值的处理有着不同的哲学。当Jackson(最流行的Java JSON处理器)遇到空字符串尝试转换为集合时,它会严格遵循类型约束,认为这是非法操作。就好比你拿着空矿泉水瓶去加油站说要"加满",工作人员肯定会拒绝你——因为容器类型根本不匹配。
在实际项目中,这类问题往往出现在迭代开发过程中。就像我的案例,最初设计时字段是字符串类型,后来需求变更为多值存储。但前端可能因为历史原因或不同开发者的习惯,仍然传递空字符串。这时如果粗暴地要求所有前端立即修改,不仅沟通成本高,还可能引发其他意外问题。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 理解JSON反序列化的底层机制
要真正解决这个问题,我们需要先了解Jackson处理JSON的基本流程。当收到一个JSON字符串时,Jackson会经历以下几个关键步骤:
- 词法分析:将JSON字符串拆分为token流
- 语法分析:构建JSON节点树(JsonNode)
- 类型绑定:根据目标Java类型进行数据转换
对于集合类型,Jackson默认期望的JSON格式是数组形式(用方括号包裹)。当遇到非数组值时,它会尝试进行智能转换,这就是所谓的"强制转换"(Coercion)。但空字符串到集合的转换默认是被禁用的,因为这种转换的语义不明确——它可能表示"无元素",也可能表示"包含一个空字符串元素"。
Jackson提供了CoercionConfig来配置这类转换行为,但全局开启强制转换可能会带来其他意想不到的副作用。这就是为什么我们需要更精确的解决方案——自定义反序列化器。
3. 手把手实现自定义反序列化器
3.1 创建EmptyStringListDeserializer类
让我们从零开始实现一个健壮的空字符串处理器。这个自定义反序列化器需要继承Jackson的JsonDeserializer基类,并指定泛型类型为List<String>:
java复制import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.JsonDeserializer;
import com.fasterxml.jackson.databind.JsonNode;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
public class EmptyStringListDeserializer extends JsonDeserializer<List<String>> {
@Override
public List<St
