导语：在 Web 应用开发中，统一的日期格式对于数据的正确传输和解析至关重要。Spring Boot 提供了多种方法来统一处理 JSON 日期格式，保证前后端的数据一致性。本文将介绍两种处理 JSON 日期格式的方法：编程式声明和配置式声明。

方式一：编程式声明

通过自定义配置类，在 Jackson 的自动配置之前预先装配一个
Jackson2ObjectMapperBuilderCustomizer，配置日期格式。

具体实现步骤

1. 创建 JacksonConfig 配置类：

import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.boot.autoconfigure.jackson.JacksonAutoConfiguration;
import org.springframework.boot.jackson.Jackson2ObjectMapperBuilderCustomizer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.time.ZoneId;
import java.util.Locale;
import java.util.TimeZone;

@Configuration
@ConditionalOnClass(ObjectMapper.class)
@ConditionalOnProperty(name = "spring.jackson.custom-config", matchIfMissing = true)
@AutoConfigureBefore(JacksonAutoConfiguration.class)  // 本装配提前于官方的自动装配
public class JacksonConfig {

    @Bean
    public Jackson2ObjectMapperBuilderCustomizer jacksonCustomizer() {
        return builder -> {
            builder.locale(Locale.CHINA);
            builder.timeZone(TimeZone.getTimeZone(ZoneId.systemDefault()));
            builder.simpleDateFormat("yyyy-MM-dd HH:mm:ss");
        };
    }
}

2. 说明：@ConditionalOnClass(ObjectMapper.class)：确保在类路径中存在 ObjectMapper 时才应用此配置。@AutoConfigureBefore(JacksonAutoConfiguration.class)：确保此配置在 Jackson 的自动配置之前生效。使用 Jackson2ObjectMapperBuilderCustomizer 自定义 JSON 日期格式。

方式二：配置式声明（推荐）

Spring Boot 提供了在 application.yml 或 application.properties 文件中配置 JSON 日期格式的方式，这种方式更为简洁和高效。

具体实现步骤

1. 编辑 application.yml 文件：

spring:
  jackson:
    date-format: yyyy-MM-dd HH:mm:ss
    locale: zh_CN
    time-zone: "GMT+8"
  http:
    converters:
      preferred-json-mapper: jackson

2. 说明：spring.jackson.date-format：指定日期格式。spring.jackson.locale：设置区域。spring.jackson.time-zone：设置时区。spring.http.converters.preferred-json-mapper：确保使用 Jackson 作为首选 JSON 转换器，否则配置可能不生效。

最佳实践

选择推荐方式

配置式声明相对更为简洁、直观，推荐作为首选解决方案。此外，可以将两种方法结合起来使用，为核心部分采用编程式声明配置，而将多变的、可能随项目需求调整的部分通过配置文件进行管理。

尽量减少重复配置

避免在代码和配置文件中同时定义日期格式，统一使用一种配置方式，以减少维护成本和潜在的冲突。

小结

通过以上两种方法，你可以轻松地统一处理 Spring Boot Web 请求中的 JSON 日期格式，保证前后端数据的一致性。无论是选择编程式声明还是配置式声明，都可以灵活应对你在开发中遇到的各种需求。

结语：统一处理 JSON 日期格式是高效开发中的重要一环。通过本文的讲解，相信你已经掌握了两种常用的处理方法。希望这些技巧能够帮助你在实际项目中更顺利地解决日期格式问题。关注今日头条，获取更多 Spring Boot 开发技巧和最佳实践！