Java 中使用 Jackson 处理多格式 JSON 日期反序列化-java教程-PHP中文网

Java 中使用 Jackson 处理多格式 JSON 日期反序列化

本文介绍如何在 Spring Boot 3（Java 17）中，为同一 Java 类中多个不同格式的日期字符串（如 ISO、英文缩写、带时区描述等）定制 Jackson 反序列化器，统一映射为 LocalDateTime。

本文介绍如何在 spring boot 3（java 17）中，为同一 java 类中多个不同格式的日期字符串（如 iso、英文缩写、带时区描述等）定制 jackson 反序列化器，统一映射为 `localdatetime`。

在实际 API 集成场景中，第三方服务返回的 JSON 响应常包含多种人类可读或标准格式的日期字段（如 "Sep 13, 2023 19:24:00 UTC"、"2023-09-13T19:24:00+00:00"、"Sep 13, 2023 at 20:24 BST"），而 Jackson 默认无法自动识别并解析这些异构格式为 LocalDateTime。此时，需为各字段分别注册自定义 JsonDeserializer。

以下是一个完整、可运行的解决方案：

✅ 步骤一：实现专用反序列化器

首先，为 ISO 8601 带偏移格式（如 "2023-09-13T19:24:00+00:00"）编写专用解析器：

public class IsoOffsetDateTimeDeserializer extends StdDeserializer<localdatetime> {
    public IsoOffsetDateTimeDeserializer() {
        super(LocalDateTime.class);
    }

    @Override
    public LocalDateTime deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        String value = p.getValueAsString();
        // 先解析为 OffsetDateTime，再转为 LocalDateTime（丢弃时区信息）
        return OffsetDateTime.parse(value, DateTimeFormatter.ISO_OFFSET_DATE_TIME)
                             .withOffsetSameInstant(ZoneOffset.UTC)
                             .toLocalDateTime();
    }
}</localdatetime>

⚠️ 注意：DateTimeFormatter.ISO_OFFSET_DATE_TIME 直接解析会抛出异常（因 LocalDateTime 不含时区），因此需先转为 OffsetDateTime，再统一转换为 UTC 时间下的 LocalDateTime，确保语义一致。

Expanso yaml-to-json
使用 Expanso Edge 管道将 YAML 输入转换为 JSON 格式。

下载

其次，为英文月份格式（如 "Sep 13, 2023 19:24:00 UTC" 和 "Sep 13, 2023 at 20:24 BST"）创建通用模式解析器，并支持灵活匹配：

public class EnglishDateTimeDeserializer extends StdDeserializer<localdatetime> {
    private static final DateTimeFormatter FORMATTER_UTC = 
        DateTimeFormatter.ofPattern("MMM dd, uuuu HH:mm:ss z", Locale.ROOT);
    private static final DateTimeFormatter FORMATTER_UK = 
        DateTimeFormatter.ofPattern("MMM dd, uuuu 'at' HH:mm z", Locale.ROOT);

    public EnglishDateTimeDeserializer() {
        super(LocalDateTime.class);
    }

    @Override
    public LocalDateTime deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        String value = p.getValueAsString();
        try {
            // 尝试匹配 "at" 格式（UK）
            if (value.contains("at")) {
                return LocalDateTime.parse(value, FORMATTER_UK);
            }
            // 否则尝试标准 UTC 格式
            return LocalDateTime.parse(value, FORMATTER_UTC);
        } catch (DateTimeParseException e) {
            throw new JsonProcessingException("Failed to parse date: " + value, p, e);
        }
    }
}</localdatetime>

✅ 步骤二：在 DTO 中按字段指定反序列化器

将自定义解析器通过 @JsonDeserialize(using = ...) 精准绑定到对应字段：

@Data
@NoArgsConstructor
@AllArgsConstructor
public class Response {

    @JsonDeserialize(using = EnglishDateTimeDeserializer.class)
    private LocalDateTime updated;

    @JsonDeserialize(using = IsoOffsetDateTimeDeserializer.class)
    private LocalDateTime updatedISO;

    @JsonProperty("updateduk")
    @JsonDeserialize(using = EnglishDateTimeDeserializer.class)
    private LocalDateTime updatedUK;
}

✅ 步骤三：验证与注意事项

✅ 时区处理建议：LocalDateTime 本身不携带时区，若业务需保留原始时区语义，推荐改用 ZonedDateTime 或 OffsetDateTime 并配合更严谨的解析逻辑。
✅ 线程安全：DateTimeFormatter 是不可变且线程安全的，上述静态复用方式完全合规。
✅ 错误容错：示例中已加入 try-catch 并包装为 JsonProcessingException，便于 Spring 全局异常处理器统一捕获。
✅ Spring Boot 自动配置兼容性：该方案完全兼容 Spring Boot 3 的 Jackson ObjectMapper 自动配置，无需额外注册模块（除非需全局启用）。