解决 cannot deserialize value of type `java.lang.string` from object value (token) 的实战指南

1次阅读

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

在 Java 开发中，JSON 反序列化是常见的数据处理操作。当我们将 JSON 字符串转换为 Java 对象时，经常会遇到 cannot deserialize value of typejava.lang.stringfrom object value (token) 的错误。这个错误通常发生在以下场景：

后端接收前端传递的 JSON 数据时
调用第三方 API 获取 JSON 响应并转换为 Java 对象时
从消息队列读取 JSON 消息进行反序列化时

这个错误会导致服务中断，影响用户体验，特别是在微服务架构中，一个服务的反序列化失败可能导致整个调用链路的失败。

这个错误的根本原因是 JSON 数据的结构与 Java 对象的定义不匹配。具体来说，有以下几种常见情况：

JSON 中的字段值是对象类型（如 {"name": {"first": "John"}}），但 Java 中对应字段声明为 String 类型
JSON 中的字段值是数组类型，但 Java 中对应字段声明为 String 类型
JSON 中的字段值是嵌套对象，但 Java 中对应字段声明为简单 String 类型

Jackson 等 JSON 库在处理这种类型不匹配时，就会抛出这个异常。

这种方法适合需要自定义反序列化逻辑的场景。通过在构造函数或工厂方法上添加注解，可以精确控制如何从 JSON 创建对象。

public class User {
    private final String name;

    @JsonCreator
    public User(@JsonProperty("name") Map<String, String> nameMap) {this.name = nameMap.get("first") + "" + nameMap.get("last");
    }
}

对于更复杂的反序列化需求，可以实现自定义的反序列化器。

public class CustomStringDeserializer extends JsonDeserializer<String> {
    @Override
    public String deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {JsonNode node = p.getCodec().readTree(p);
        if (node.isObject()) {return node.get("value").asText();}
        return node.asText();}
}

// 使用方式
@JsonDeserialize(using = CustomStringDeserializer.class)
private String customField;

当处理泛型集合时，TypeReference 可以确保类型信息不被擦除。

String json = "{\"data\":\"value\"}";
ObjectMapper mapper = new ObjectMapper();
Map<String, String> result = mapper.readValue(json, new TypeReference<Map<String, String>>() {});

如果使用 Gson，可以通过 TypeToken 和自定义 JsonDeserializer 实现类似功能。

Gson gson = new GsonBuilder()
    .registerTypeAdapter(String.class, new StringDeserializer())
    .create();

class StringDeserializer implements JsonDeserializer<String> {public String deserialize(JsonElement json, Type typeOfT, JsonDeserializationContext context) {if (json.isJsonObject()) {return json.getAsJsonObject().get("value").getAsString();}
        return json.getAsString();}
}