Jackson反序列化空或全注释的YAML Map时报错如何解决
问题根因
你当前使用的2.1.4版本Jackson对YAML的空Map节点解析存在兼容问题:当myMap下方无任何有效键值对(或所有键值对被注释)时,Jackson会将该节点的值识别为空字符串,而非空Map或null,默认无法将空字符串转换为Map<String, String>类型,因此抛出反序列化异常。
解决方案
方案1:全局配置反序列化特性(推荐)
开启Jackson空字符串转null的特性,同时给POJO中的Map字段设置默认空值,即可兼容两种场景:
- 调整ObjectMapper初始化配置:
import com.fasterxml.jackson.databind.DeserializationFeature; // ... ObjectMapper mapper = new ObjectMapper(new YAMLFactory()) // 允许将空字符串识别为null .enable(DeserializationFeature.ACCEPT_EMPTY_STRING_AS_NULL_OBJECT);
- 修改POJO的Map字段,初始化默认空Map:
class Config { @JsonProperty Map<String, String> myMap = new HashMap<>(); // 剩余原有代码保持不变 }
该方案无需修改业务逻辑,两种场景均可正常运行:
- 有键值对时正常反序列化得到对应Map
- 无有效键值对时得到初始化的空Map,无报错
方案2:兼容低版本特殊处理
如果不能修改全局配置,可给字段添加自定义Setter处理空字符串场景:
class Config { @JsonProperty Map<String, String> myMap = new HashMap<>(); @JsonSetter("myMap") public void setMyMap(Object value) { if (value instanceof Map) { this.myMap = (Map<String, String>) value; } else if (value == null || "".equals(value)) { this.myMap = new HashMap<>(); } } // 剩余原有代码保持不变 }
方案3:升级Jackson版本
如果项目允许升级依赖,将Jackson相关依赖升级到2.12及以上版本,该版本已修复YAML空Map节点的解析问题,无需额外配置即可正常识别空Map。
<dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>2.15.2</version> </dependency> <dependency> <groupId>com.fasterxml.jackson.dataformat</groupId> <artifactId>jackson-dataformat-yaml</artifactId> <version>2.15.2</version> </dependency>
内容的提问来源于stack exchange,提问作者Ali Ben Messaoud
相关产品推荐
相关产品推荐

