Oracle JDBC驱动依赖JVM时区而非系统时区，必须通过-Duser.timezone=Asia/Shanghai显式设置，仅挂载/etc/localtime或设TZ环境变量无效；serverTimezone是MySQL参数，Oracle驱动不识别。
Oracle JDBC驱动读取的是JVM时区，不是容器系统时区
oracle jdbc驱动本身不直接读取linux系统时间，而是通过jdbc客户端所在的jvm获取system.currenttimemillis()和java.time.clock.systemdefaultzone()——也就是说，它依赖java进程的时区设置，而非/etc/localtime是否挂载正确。很多用户挂载了/etc/localtime后发现date命令显示正确，但jdbc写入数据库的时间仍是utc，根源就在这里。
常见错误现象：数据库中SYSDATE或CURRENT_TIMESTAMP看起来正常（因为Oracle服务端自己处理），但Java应用用PreparedStatement.setTimestamp()写入的时间比预期早8小时；或者ResultSet.getTimestamp()返回的时间被自动转换成本地时区后错乱。
- JVM启动时未指定
-Duser.timezone=Asia/Shanghai，导致Java默认用UTC - 即使容器
TZ环境变量设为Asia/Shanghai，JVM仍可能忽略它（尤其在Alpine镜像中） - Spring Boot应用未显式配置
spring.jackson.time-zone或spring.jpa.properties.hibernate.jdbc.time_zone
必须在JVM启动参数里强制指定user.timezone
这是最直接、最可靠的方案。仅靠挂载/etc/localtime或设置TZ环境变量，对JVM内部时区无影响。Oracle JDBC驱动调用java.util.TimeZone.getDefault()时，优先检查user.timezone系统属性。
实操建议：
- 在
docker run命令中加入：-e JAVA_TOOL_OPTIONS="-Duser.timezone=Asia/Shanghai"（推荐，对所有Java进程生效） - 或在启动脚本中明确传递：
java -Duser.timezone=Asia/Shanghai -jar app.jar - 若用Spring Boot，可在
application.yml中加：spring: jackson: time-zone: Asia/Shanghai，但这只影响JSON序列化，不影响JDBC底层行为
注意：Asia/Shanghai不能简写为CST（存在歧义），也不能用GMT+8（Java不识别偏移量字符串）。
Dockerfile里预装tzdata + 显式链接localtime还不够
很多Dockerfile会这样写：RUN apk add --no-cache tzdata && cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime，这能让date命令输出正确，但JVM依然可能读不到。原因在于：Alpine等精简镜像默认不包含完整时区数据，java.time.ZoneId.systemDefault()可能 fallback 到UTC。
正确做法是：
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- Alpine镜像必须安装
tzdata包，并确保/usr/share/zoneinfo/Asia/Shanghai真实存在 - 同时执行
ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime+echo "Asia/Shanghai" > /etc/timezone - 但最终仍要叠加
-Duser.timezone，因为JVM不依赖/etc/timezone文件
Debian/Ubuntu系镜像自带tzdata，挂载宿主机/etc/localtime通常够用，但JVM层仍建议加固。
Oracle连接URL里加serverTimezone参数只解决MySQL，对Oracle无效
有人尝试在JDBC URL里加?serverTimezone=Asia/Shanghai，这其实是MySQL Connector/J的参数，Oracle JDBC驱动（ojdbc8.jar等）完全不识别该参数，加了也白加，还会让URL解析失败或触发警告。
Oracle真正相关的配置只有两个地方：
- JVM层面：
-Duser.timezone（必须） - Oracle服务端层面：
ALTER DATABASE SET TIME_ZONE = 'Asia/Shanghai'（影响SYSDATE等，但不影响JDBC传入的时间值）
如果应用混合使用MySQL和Oracle，别把MySQL的套路套到Oracle上——参数名、生效逻辑、甚至时区缩写规则（如Oracle接受Asia/Shanghai，但不接受CTT）都不同。
最容易被忽略的点：JVM参数必须在Java进程启动前注入，容器重启后不会自动继承宿主机时区；而TZ环境变量对JVM是“隐形”的，除非你手动在代码里调用TimeZone.setDefault()——这属于反模式，不推荐。
