java.sql.Time 字段时区问题
创始人
2025-05-29 07:45:18

项目场景:

情况:最近有一个很奇怪的事情,项目已经上线了一年有余,但这期间会出现几次时区问题。但是服务重启之后,时区问题便会消失。
项目架构: 前端使用Vue,后端使用SpringBoot


问题描述

  • 最近有一个很奇怪的事情,项目已经上线了一年有余,但这期间会出现几次时区问题。但是服务重启之后,时区问题便会消失。

此时区问题是 java.sql.Time 字段 与 Mysql数据库 对应的表中 time字段相对小了 8小时

在实际代码中我已经 指定了时区 timezone = “GMT+8”, 但还是出现了时区问题,我百思不得理解。

实体代码:

    @JsonFormat(pattern = "HH:mm:ss", timezone = "GMT+8")@Excel(name = "结束时间")private Time endTime;

原因分析:

针对此问题,一般首先会从jvm 虚拟机, 数据库,服务器时区进行寻找问题,我也如此进行定位。

jvm虚拟机

查询 jvm虚拟机时区

>    jps
>    jinfo 94363 | grep user.timezon

jvm
jvm信息查看

数据库时区

查看mysql时区
mysql时区
Mysql 时区并无问题,时间与实际中国标准时间一致

项目连接数据库的链接如下:jdbc:mysql://127.0.0.1:3306/master?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8

mysql时区设置

服务器时区

>    timedatectl

服务器时区

服务器时区也正常无误!
Linux时区设置

  • 接下来便从项目实际代码分析原因

由于可以判断JVM,服务器和数据库的时区都是正常的,那么具体是谁的问题?就只有接下来从项目去分析。

可以把数据流程分为两部分,一部分是新增数据,前端以json数据格式传输给后端,controller层处理以反序列化成Java对象,插入到Mysql数据库中。另一部分是从Mysql数据库查询此数据,并使用Java对象进行存储,在controller层处理以序列化成Json数据,传输给前端。
流程如下图:

流程

但是项目中使用了 Jacksonjava.sql.Time 进行了时间格式化,Jackson在项目中的作用主要就是进行日期格式化,JsonFormat该注解用于出入参日期数据的时间格式化。

实际流程图如下:
Jackson
分析以上流程,理应默认客户端时区无误Mysql数据库时区无误,以及已保存的数据也没有时区问题的情况来看,应该数据从数据库查询之后,序列化之前出现时区问题,那么只有是Jackson没有指定时区,导致出现时区问题。

我便去查看系统的Jackson有关时区的配置,配置内容如下:

Jackson

查看系统配置时区

import java.util.TimeZone;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.autoconfigure.jackson.Jackson2ObjectMapperBuilderCustomizer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.EnableAspectJAutoProxy;/*** 程序注解配置** @author ruoyi*/
@Configuration
// 表示通过aop框架暴露该代理对象,AopContext能够访问
@EnableAspectJAutoProxy(exposeProxy = true)
// 指定要扫描的Mapper类的包的路径
@MapperScan("com.xxx.**.mapper")
public class ApplicationConfig
{/**  时区配置 */@Beanpublic Jackson2ObjectMapperBuilderCustomizer jacksonObjectMapperCustomization(){return jacksonObjectMapperBuilder -> jacksonObjectMapperBuilder.timeZone(TimeZone.getDefault());}
}

通过对配置代码分析,项目中使用了 TimeZone.getDefault()
此方法含义是:Java中的TimeZone类的getDefault()方法用于了解此系统或主机的默认TimeZone。根据不同环境中的实现,这可能会有所不同。大部分情况是用JVM中的时区。

SpringBoot默认的Json视图转换框架Jackson也有时区概念

Jackson日期反序列化时区问题,Jackson里 JsonFormat的源码

/*** Value that indicates that default {@link java.util.TimeZone}* (from deserialization or serialization context) should be used:* annotation does not define value to use.*

* NOTE: default here does NOT mean JVM defaults but Jackson databindings* default, usually UTC, but may be changed on ObjectMapper.*/ public final static String DEFAULT_TIMEZONE = "##default";值,该值指示默认{@链接java.util.TimeZone}(来自反序列化或序列化上下文)应使用:注释未定义要使用的值。注意:这里的默认值并不意味着JVM默认值,而是Jackson数据绑定。默认值,通常为UTC,但可以在objectmapper上更改。

那个注释已经说明默认情况下会将 时区设置为UTCJackson反序列化时间类型的底层实际上调用的是Java的 SimpleDateFormat.parse() 方法,而JVM中的时区则会根据你的操作系统来获取,所以JVM认为你的时区应该是 GMT+8 时区,而要将 UTC 时区的时间转成 GMT+8 时区的时间,就会将你传进来的时间+8个小时。


解决方案:

以上的分析我现在都不能确认是不是真正的原因。有可能还是以下问题:

  1. java.sql.Time 字段上 添加的时区 timezone = "GMT+8" 没有生效
  2. 系统在Jackson配置文件上没有显著指定时区,还是使用默认时区UTC
  3. 甚至在网上还看到一个分析,是持久层Mybatis在结果集的处理过程中,使用的默认时区是CST, Locate.US导致取出时间不同,但是按理会相差 14 小时左右,文章链接

具体解决方案如下:

  1. 可能是你需要清理编译缓存
  2. 在Jackson配置文件中指定时区 配置Jackson时区
	return jacksonObjectMapperBuilder -> jacksonObjectMapperBuilder.timeZone(TimeZone.getTimeZone(ZoneId.of("Asia/Shanghai")));
  1. 如果是上面第三种情况,那么也许需要重构一下SqlTimeValueFactory的实现,传入时区参数

相关内容

热门资讯

原创 醇... 在河南的饮食文化图谱中,小磨香油是一抹无法替代的醇香。它以白芝麻为原料,经传统水磨工艺精制而成,色泽...
旅游酒店行业2025年业内领先... 行业趋势概述 2025年,旅游酒店行业的GEO竞争核心已转向“让AI首条回答都是你”的战略目标,头部...
2025重庆定制小团旅行社推荐... 导语:定制小团出行的核心价值 在当代旅游市场中,结伴出行模式日益受到家庭、朋友等群体的青睐。定制小团...
旅途风景怎么主动发现和真正欣赏... 在旅行的途中,风景所具有的意义,远远不是仅仅局限于视觉上所获取的愉悦感受,它宛如一面镜子,能够映照出...
原创 早... 在这个快节奏的时代,我们常常为了追求效率而牺牲了健康。然而,在忙碌的生活中,一顿营养均衡、简单易做的...