JSON反序列化时出现“Cannot deserialize value of type `java.util.Date` from String "2025-04-17 14”，如何解决？

Question

在JSON反序列化过程中，若遇到“Cannot deserialize value of type `java.util.Date` from String "2025-04-17 14”错误，通常是因为日期格式与反序列化器的预期格式不匹配。例如，`java.util.Date`默认无法直接解析非标准格式的字符串。 解决方法如下： 1. **指定日期格式**：使用Jackson库时，可通过`@JsonFormat`注解为字段定义日期格式，如`@JsonFormat(pattern = "yyyy-MM-dd HH")`。 2. **自定义反序列化器**：创建一个继承`StdDeserializer`的类，重写`deserialize`方法，手动解析日期字符串。 3. **全局配置**：通过`ObjectMapper`设置全局日期格式，例如`objectMapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH"));`。 确保JSON中的日期格式与代码中定义的格式一致，避免解析异常。

Answer 1

1. 问题概述

在JSON反序列化过程中，可能会遇到类似“Cannot deserialize value of type `java.util.Date` from String '2025-04-17 14'”的错误。这类问题通常源于日期格式与反序列化器预期的格式不匹配。例如，`java.util.Date`默认情况下无法直接解析非标准格式的字符串。

以下是可能导致此问题的一些常见场景：

• JSON数据中的日期格式不符合代码中定义的格式。
• 未正确配置反序列化器的日期解析规则。
• 使用的库（如Jackson）未被正确初始化或配置。

2. 常见解决方案

解决此类问题的方法有多种，以下是从简单到复杂的技术实现方案：

1. 指定日期格式：通过使用Jackson库中的`@JsonFormat`注解，为字段定义明确的日期格式。例如：

@JsonFormat(pattern = "yyyy-MM-dd HH")
    private Date eventTime;
    

这种方式适用于单个字段的日期格式调整。

1. 自定义反序列化器：创建一个继承`StdDeserializer`的类，并重写`deserialize`方法以手动解析日期字符串。例如：

public class CustomDateDeserializer extends StdDeserializer {
        public CustomDateDeserializer() {
            this(null);
        }
    
        public CustomDateDeserializer(Class vc) {
            super(vc);
        }
    
        @Override
        public Date deserialize(JsonParser p, DeserializationContext ctxt) 
                throws IOException, JsonProcessingException {
            String date = p.getText();
            SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd HH");
            try {
                return formatter.parse(date);
            } catch (ParseException e) {
                throw new RuntimeException(e);
            }
        }
    }
    

自定义反序列化器提供了更大的灵活性，但需要额外的开发和维护成本。

3. 全局配置优化

如果项目中存在大量日期字段，逐一添加注解可能不够高效。此时可以通过`ObjectMapper`设置全局日期格式：

ObjectMapper objectMapper = new ObjectMapper();
    objectMapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH"));
    

这种全局配置方式可以减少重复代码，同时确保所有日期字段的一致性。

4. 分析与决策流程

针对上述问题，可以根据实际情况选择合适的解决方案。以下是一个简单的决策流程图：

graph TD;
            A[问题描述] --> B{是否有多个字段？};
            B --是--> C[全局配置];
            B --否--> D{是否需要特殊逻辑？};
            D --是--> E[自定义反序列化器];
            D --否--> F[使用@JsonFormat注解];

5. 实际应用示例

假设我们有一个JSON对象如下：

字段名	值
eventTime	2025-04-17 14

对应的Java类定义为：

public class Event {
        @JsonFormat(pattern = "yyyy-MM-dd HH")
        private Date eventTime;

        // Getter and Setter
    }
    

通过以上配置，可以成功解析JSON中的日期字段。