GreedyAbyss1. Spring Boot 接口日期格式化方法概述
在前后端分离的开发模式中，日期时间格式的统一处理是个高频痛点问题。作为Java开发者，我们经常遇到以下几种典型场景：
- 后端返回的Date/LocalDateTime对象被Jackson默认序列化为长整型时间戳
- 前端提交的日期字符串在后端反序列化时抛出格式异常
- 不同接口对同一日期字段需要展示不同格式（如列表页显示yyyy-MM-dd，详情页显示完整时间）
经过多个项目的实践验证，我总结出Spring Boot中最实用的6种日期格式化方案。这些方法各有适用场景，下面我会结合具体代码示例，详细分析每种方案的实现原理、使用技巧和避坑指南。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 全局时间格式化配置
2.1 基础配置方案
在application.properties中添加：
properties复制# 全局日期格式
spring.jackson.date-format=yyyy-MM-dd HH:mm:ss
# 时区设置（中国标准时间）
spring.jackson.time-zone=GMT+8
或者在application.yml中配置：
yaml复制spring:
jackson:
date-format: yyyy-MM-dd HH:mm:ss
time-zone: GMT+8
关键点：time-zone配置必须与date-format配套使用，否则可能造成时间偏差问题
2.2 实现原理深度解析
当Controller方法返回对象时，Spring MVC会通过Jackson的ObjectMapper执行序列化。整个过程可以分为三个关键阶段：
- 类型识别阶段：Jackson通过反射识别字段类型，发现java.util.Date等时间类型字段
- 格式应用阶段：检查是否配置了spring.jackson.date-format，如有则应用该格式
- 时区转换阶段：根据time-zone配置将UTC时间转换为目标时区时间
2.3 实战注意事项
- LocalDateTime支持问题：该配置对java.util.Date生效，但LocalDateTime需要额外配置（见第6节方案）