解决 JSON 反序列化错误：cannot deserialize value of type `java.lang.string` 的实战指南

1次阅读

没有评论

共计 1970 个字符，预计需要花费 5 分钟才能阅读完成。

JSON 反序列化是 Java 开发中常见的操作，但在处理 JSON 数据时，经常会遇到 cannot deserialize value of typejava.lang.string“ 的错误。这个错误通常出现在以下几种场景中：

字段类型不匹配 ：JSON 中的字段值与 Java 对象中的字段类型不一致。例如，JSON 中的字段是数字，但 Java 对象中的字段是字符串。
空值处理 ：JSON 中的字段值为 null，但 Java 对象中的字段不允许为空（如 @NotNull 注解标记的字段）。
字段名不一致 ：JSON 中的字段名与 Java 对象中的字段名不一致，导致反序列化失败。
嵌套对象处理 ：JSON 中的嵌套对象结构复杂，而 Java 对象的定义无法正确映射。

针对上述问题，以下是几种常见的解决方案：

使用注解配置 ：通过 @JsonIgnore、@JsonProperty 等注解来调整反序列化行为。
@JsonProperty：用于指定 JSON 字段名与 Java 字段名的映射关系。
@JsonIgnore：忽略某些字段，避免反序列化时出错。
自定义反序列化器 ：通过实现 JsonDeserializer 接口，自定义反序列化逻辑，处理复杂的 JSON 结构。
配置全局反序列化选项 ：在 ObjectMapper 或 Gson 中配置全局选项，如忽略未知字段、允许空值等。
使用 DTO 对象 ：定义专门用于反序列化的数据传输对象（DTO），避免直接使用业务对象进行反序列化。

以下是一个使用 Jackson 库的完整代码示例：

import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.annotation.JsonDeserialize;

public class User {@JsonProperty("user_name")
    private String name;

    @JsonDeserialize(using = CustomDeserializer.class)
    private String age;

    // 省略 getter 和 setter
}

public class CustomDeserializer extends JsonDeserializer<String> {
    @Override
    public String deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        // 自定义反序列化逻辑
        return p.getValueAsString();}
}

public class Main {public static void main(String[] args) throws Exception {String json = "{\"user_name\":\"John\",\"age\":25}";
        ObjectMapper mapper = new ObjectMapper();
        User user = mapper.readValue(json, User.class);
        System.out.println(user.getName()); // 输出: John
    }
}