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

1次阅读

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

这个错误通常出现在使用 Jackson 库进行 JSON 反序列化时，当 JSON 数据中的某个字段在 Java 对象中被定义为 String 类型，但实际接收到的 JSON 数据中该字段却是一个数组（Array）时，就会抛出这个异常。

典型的错误日志如下：

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\",\"Doe\"]}"; line: 1, column: 10] (through reference chain: com.example.User["name"])

这个错误的根本原因是 JSON 数据结构与 Java 对象模型之间的不匹配。具体来说：

在 Java 对象中，某个字段被声明为 String 类型
但在 JSON 数据中，对应的字段值是一个数组（用方括号 [] 表示）
Jackson 尝试将数组反序列化为 String 时失败

例如：

Java 类定义：

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

JSON 数据：

{"name": ["John", "Doe"]
}

这种情况下，Jackson 不知道如何将数组 [“John”, “Doe”] 转换为单个 String，因此抛出异常。

如果可能，最简单的解决方案是修改 JSON 数据结构，使其与 Java 对象匹配。例如将数组改为单个字符串：

{"name": "John Doe"}

这种方法适用于你有控制权修改 JSON 数据源的情况。

如果无法修改 JSON 数据，可以在 Java 类中使用 @JsonDeserialize 注解指定如何处理数组：

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

然后创建一个自定义的反序列化器：

public class ArrayToStringDeserializer extends StdDeserializer<String> {public ArrayToStringDeserializer() {super(String.class);
    }

    @Override
    public String deserialize(JsonParser p, DeserializationContext ctxt) 
        throws IOException {
        // 如果值是数组，取第一个元素
        if (p.currentToken() == JsonToken.START_ARRAY) {p.nextToken();
            return p.getText();}
        // 否则按普通字符串处理
        return p.getText();}
}

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

public class UserDeserializer extends StdDeserializer<User> {public UserDeserializer() {super(User.class);
    }

    @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()) {
            // 处理数组情况，例如连接所有元素
            StringBuilder sb = new StringBuilder();
            for (JsonElement element : nameNode) {if (sb.length() > 0) sb.append(" ");
                sb.append(element.getAsString());
            }
            user.setName(sb.toString());
        } else {user.setName(nameNode.asText());
        }

        return user;
    }
}

然后注册这个反序列化器：

SimpleModule module = new SimpleModule();
module.addDeserializer(User.class, new UserDeserializer());
ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(module);