Java读取JSON文件时LocalDate反序列化报错问题咨询

问题描述 #

导入JSON文件时尝试将日期格式化为dd.MM.yyyy，但持续触发报错：

Cannot deserialize value of type java.time.LocalDate from String "09.09.1977": Failed to deserialize java.time.LocalDate

尝试过多种注解组合仍无效，示例注解如下：

@DateTimeFormat(pattern = "dd.MM.yyyy", iso = DateTimeFormat.ISO.DATE_TIME)
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "dd.MM.yyyy")
@JsonDeserialize(using = LocalDateTimeDeserializer.class)
@JsonSerialize(using = LocalDateTimeSerializer.class)
private LocalDate startDate;

同时有两个核心疑问，以及格式转换需求：

1. JSON文件中的日期字段是否必须采用特定格式？
2. 日期字段所在的实体类和DTO类中，是否需要像示例这样在字段上添加相关格式注解？

读取并转换数据的代码块：

final List<Employee> employees = requests.stream()
                .map(EmployeeRequestMapper::mapToEntity)
                .toList();

问题解答 #

1. JSON文件中的日期字段是否必须采用特定格式？ #

不是必须，但必须和你的反序列化配置匹配。Jackson默认会用ISO-8601格式（如yyyy-MM-dd）解析日期字符串，如果你的JSON里是dd.MM.yyyy格式，必须明确告诉Jackson对应的解析规则，否则就会触发格式不匹配的报错。

2. 实体类/DTO类是否需要添加格式注解？ #

需要，但你的注解组合存在错误，导致无效：

• 字段类型是LocalDate，但你用了LocalDateTimeDeserializer/LocalDateTimeSerializer，类型完全不匹配，应该替换为LocalDateDeserializer和LocalDateSerializer
• @DateTimeFormat是Spring MVC用于处理HTTP请求参数的注解，和Jackson的JSON反序列化无关，无需添加
• @DateTimeFormat中同时指定pattern和iso = DateTimeFormat.ISO.DATE_TIME属于冲突配置，完全没必要

正确解决方案 #

方案1：字段级注解修正 #

把字段上的注解改成以下正确组合：

@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "dd.MM.yyyy")
@JsonDeserialize(using = LocalDateDeserializer.class)
@JsonSerialize(using = LocalDateSerializer.class)
private LocalDate startDate;

方案2：全局Jackson配置（推荐） #

如果项目中所有LocalDate类型都用dd.MM.yyyy格式，可以配置全局规则，避免每个字段重复加注解：

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        JavaTimeModule module = new JavaTimeModule();
        DateTimeFormatter dateFormatter = DateTimeFormatter.ofPattern("dd.MM.yyyy");
        
        module.addDeserializer(LocalDate.class, new LocalDateDeserializer(dateFormatter));
        module.addSerializer(LocalDate.class, new LocalDateSerializer(dateFormatter));
        
        return new ObjectMapper()
                .registerModule(module);
    }
}

方案3：手动在Mapper中解析 #

如果EmployeeRequest中的日期是字符串类型，也可以在映射时手动解析：

// 示例Mapper方法
public static Employee mapToEntity(EmployeeRequest request) {
    Employee employee = new Employee();
    DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd.MM.yyyy");
    employee.setStartDate(LocalDate.parse(request.getStartDate(), formatter));
    // 其他字段映射逻辑
    return employee;
}

内容的提问来源于stack exchange，提问作者user19601475