oracle jdbc驱动默认按数据库服务器时区解析时间字段，而非jvm时区；必须在连接url中显式配置oracle.jdbc.timezoneasregion=true和oracle.jdbc.mapdatetotimestamp=false，并用gettimestamp(int, calendar)指定calendar时区读取timestamp with time zone字段。
oracle jdbc驱动默认不尊重jvm时区，timestamp字段会按数据库服务器时区解析
java应用从oracle读取 timestamp with time zone 或 timestamp 字段时，如果没显式配置时区，oracle.jdbc.driver.oracledriver 会优先使用数据库服务器所在操作系统的时区（而非jvm的 user.timezone），导致同一时间值在不同环境解析出不同时戳。典型现象是：开发机查出来是 2024-05-20 14:30:00.0，测试环境却变成 2024-05-20 06:30:00.0（相差8小时）。
这不是Java Timestamp 类的bug，而是Oracle JDBC驱动的默认行为——它把数据库返回的裸二进制时间戳，直接按服务端时区“硬解”成 java.sql.Timestamp。
必须在JDBC URL中显式设置 oracle.jdbc.timezoneAsRegion 和 oracle.jdbc.mapDateToTimestamp
仅靠 serverTimezone（MySQL风格）或JVM启动参数 -Duser.timezone=Asia/Shanghai 对Oracle驱动无效。正确做法是在连接URL里加两个关键参数：
-
oracle.jdbc.timezoneAsRegion=true：启用时区区域名（如Asia/Shanghai）而非偏移量（如+08:00）解析，避免夏令时歧义 -
oracle.jdbc.mapDateToTimestamp=false：防止驱动把DATE字段自动映射为带时区的Timestamp，干扰原始语义
完整URL示例：jdbc:oracle:thin:@//db.example.com:1521/ORCL?oracle.jdbc.timezoneAsRegion=true&oracle.jdbc.mapDateToTimestamp=false
读取 TIMESTAMP WITH TIME ZONE 必须用 getTimestamp(int, Calendar) 指定时区
即使URL里配了时区参数，对 TIMESTAMP WITH TIME ZONE 列，驱动仍不会自动转换。必须显式传入 Calendar 实例：
Calendar cal = Calendar.getInstance(TimeZone.getTimeZone("Asia/Shanghai"));
Timestamp ts = rs.getTimestamp("create_time", cal);
注意：
- 不要用 rs.getTimestamp("create_time")，它走默认服务器时区路径
- Calendar 必须用 TimeZone.getTimeZone("Asia/Shanghai") 构造，不能用 TimeZone.getDefault()（可能被容器覆盖）
- 若用MyBatis，需自定义 TypeHandler 封装该逻辑，否则 @Select 注解直出结果仍会错
Spring Boot + HikariCP场景下，spring.datasource.hikari.data-source-properties 是唯一生效位置
Spring Boot 2.4+ 默认不识别 oracle.jdbc.* 这类非标准JDBC属性。必须通过HikariCP的 data-source-properties 透传：
spring:
datasource:
hikari:
data-source-properties:
oracle.jdbc.timezoneAsRegion: "true"
oracle.jdbc.mapDateToTimestamp: "false"
常见错误：
- 写在 spring.datasource.url 末尾：HikariCP会过滤掉不认识的参数
- 写成 connection-properties（旧版配置名）：Spring Boot 2.3+ 已废弃
- 混用 oracle.jdbc.ThinDriver 的系统属性方式（如 -Doracle.jdbc.timezoneAsRegion=true）：驱动只读URL和 DataSource set方法传入的属性，忽略JVM系统属性
时区问题最麻烦的地方不在配置本身，而在于它只在跨时区部署、或数据库与应用服务器物理分离时才暴露——本地单机调试永远正常。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
