如何解决 ‘cannot deserialize value of type `java.lang.string` from array value’ 错误：新手避坑指南

1次阅读

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

在 Java 开发中，当我们使用 Jackson 或其他 JSON 库进行反序列化时，经常会遇到这样的错误：cannot deserialize value of typejava.lang.stringfrom array value。这个错误通常发生在 JSON 数据结构和 Java 对象模型不匹配的情况下。

典型的错误日志如下：

com.fasterxml.jackson.databind.exc.MismatchedInputException: Cannot deserialize value of type `java.lang.String` from Array value (token `JsonToken.START_ARRAY`)
 at [Source: (String)"{\"name\":[\"John\"]}"; line: 1, column: 10] (through reference chain: com.example.User["name"])

这个错误的根本原因是 JSON 数据结构与 Java 对象模型之间的类型不匹配。具体来说，JSON 中某个字段的值是一个数组（用方括号 [] 表示），但在 Java 对象中对应的字段却被声明为 String 类型。

例如：

{"name": ["John"]
}

对应的 Java 类可能是：

public class User {
    private String name;
    // getters and setters
}

这种情况下，Jackson 尝试将一个数组值反序列化为 String 类型，自然会失败。

最直接的解决方案是确保 JSON 结构与 Java 对象匹配。如果 Java 类中 name 字段是 String 类型，那么 JSON 中的 name 也应该是字符串值，而不是数组。

修改后的 JSON：

{"name": "John"}

如果无法修改 JSON 结构，可以在 Java 类中使用 @JsonDeserialize 注解来指定如何处理数组。例如，可以取数组的第一个元素作为 String 值。

public class User {@JsonDeserialize(using = FirstElementDeserializer.class)
    private String name;
    // getters and setters
}

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

对于更复杂的情况，可以实现一个完整的自定义反序列化器。

public class UserDeserializer extends StdDeserializer<User> {public UserDeserializer() {this(null);
    }

    public UserDeserializer(Class<?> vc) {super(vc);
    }

    @Override
    public User deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {JsonNode node = p.getCodec().readTree(p);
        User user = new User();
        JsonNode nameNode = node.get("name");
        if (nameNode.isArray()) {user.setName(nameNode.get(0).asText());
        } else {user.setName(nameNode.asText());
        }
        return user;
    }
}

// 使用方式
ObjectMapper mapper = new ObjectMapper();
SimpleModule module = new SimpleModule();
module.addDeserializer(User.class, new UserDeserializer());
mapper.registerModule(module);
User user = mapper.readValue(json, User.class);