Java Spring MVC项目生产环境日期偏移1天问题排查求助

1. 检查JSTL <fmt:formatDate> 标签的时区配置 #

<fmt:formatDate>默认不会使用JVM通过TimeZone.getDefault()设置的时区，未显式指定timeZone属性时会默认使用UTC时区，极易出现跨天偏移。
修复方案：在标签中显式指定业务使用的时区，示例如下：

<fmt:formatDate pattern="dd-MM-yyyy" value="${child.dateNaissance}" var="myDateVar" timeZone="Europe/Paris"/>

将Europe/Paris替换为你实际使用的时区标识即可。

2. 检查日期绑定的时区设置 #

你当前@InitBinder中初始化的SimpleDateFormat没有显式指定时区，解析日期字符串时会使用上下文默认时区，可能和预期不一致：传入的日期字符串默认补00:00:00，若解析时使用的时区比业务时区早，就会出现差1天的问题。
修复方案：给SimpleDateFormat显式设置时区：

@InitBinder
public void initBinder(WebDataBinder binder) {
    SimpleDateFormat dateFormat = new SimpleDateFormat("dd-MM-yyyy");
    dateFormat.setLenient(false);
    // 新增时区设置，替换为实际时区
    dateFormat.setTimeZone(TimeZone.getTimeZone("Europe/Paris"));
    CustomDateEditor editor = new CustomDateEditor(dateFormat, true);
    binder.registerCustomEditor(Date.class, editor);
}

3. 检查数据库及JDBC连接的时区配置 #

即使应用服务器时区正确，JDBC连接和数据库本身的时区不一致也会导致存储时日期偏移：

• 排查JDBC连接串是否显式指定了时区，比如MySQL的连接串需要添加参数：&serverTimezone=Europe/Paris
• 排查数据库实例的全局时区、表字段的时区属性是否和业务时区一致

4. 排查前后端提交的原始数据 #

可以分别在两端加日志定位偏移出现的环节：

• 前端提交前打印表单中日期输入框的实际字符串值，确认提交的内容和选择的日期一致
• 后端接收请求时先打印获取到的原始日期参数值，再打印解析后的Date对象的时间戳，确认是解析环节出错还是后续存储环节出错

5. 检查Spring全局时区配置 #

排查Spring配置文件中是否设置了spring.mvc.timezone之类的全局时区参数，该参数会覆盖JVM默认时区，导致日期解析逻辑和预期不一致。

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