Spark写入Oracle报ORA-01882时区未找到错误求助

这个问题我之前帮团队排查过类似的情况，核心原因是Spark作业运行时的JVM时区配置和Oracle数据库所需的时区不匹配，再加上spark-shell和spark-submit的运行环境参数差异，才导致了前者正常、后者报错的矛盾现象。

错误根源拆解 #

你看到的ORA-01882: timezone region not found是直接触发点：Oracle驱动在建立连接时，会执行递归SQL来处理时区相关的配置，如果JVM的时区设置是Oracle无法识别的（比如模糊的CST，或者不存在的时区ID），就会抛出这个错误。而ORA-00604是递归SQL执行失败的上层报错，本质还是时区问题。

至于为什么spark-shell能正常运行？因为交互式的spark-shell会继承你当前终端的时区环境变量（比如TZ），而spark-submit在集群中运行时，通常是用系统服务用户启动，没有继承这个时区配置，或者集群节点的默认JVM时区和你的终端不一致。同一spark-submit在其他集群正常，也侧面说明这个集群的节点时区/JVM配置有差异。

具体解决方案 #

按优先级尝试以下方法：

1. 在spark-submit命令中强制指定JVM时区

直接在提交命令中给Driver和Executor都加上时区参数，替换成你的Oracle数据库对应的时区（比如Asia/Shanghai或UTC）：

spark-submit \
  --conf "spark.driver.extraJavaOptions=-Duser.timezone=Asia/Shanghai" \
  --conf "spark.executor.extraJavaOptions=-Duser.timezone=Asia/Shanghai" \
  --class your.main.Class \
  --master yarn \
  your-jar-file.jar

⚠️ 必须同时设置Driver和Executor的参数，因为数据写入操作是在Executor节点执行的。

2. 在JDBC URL中添加时区参数

除了JVM层面的配置，还可以在Oracle JDBC连接URL中明确指定时区，避免驱动识别时区出错：

val oracleUrl = "jdbc:oracle:thin:@//your-db-host:1521/your-service-name?oracle.jdbc.timezoneAsRegion=false&timezone=Asia/Shanghai"

这里oracle.jdbc.timezoneAsRegion=false的作用是让驱动使用明确的时区ID，而不是尝试匹配Oracle的时区区域名，减少识别失败的概率。

3. 检查并修正集群节点的系统时区

如果上面的方法无效，可能是集群节点的系统时区本身就是Oracle无法识别的模糊值（比如CST）。登录集群节点执行以下命令查看当前时区：

timedatectl

如果显示的时区不是明确的地区时区（比如Asia/Shanghai），可以用以下命令修改：

sudo timedatectl set-timezone Asia/Shanghai

修改后建议重启Spark集群或相关节点，确保配置生效。

4. 配置Spark全局默认时区

如果希望所有Spark作业都使用统一的时区，可以修改Spark的spark-defaults.conf文件，添加以下配置：

spark.driver.extraJavaOptions -Duser.timezone=Asia/Shanghai
spark.executor.extraJavaOptions -Duser.timezone=Asia/Shanghai

保存后重启Spark集群，后续所有提交的作业都会自动继承这个时区设置。

验证方法 #

修改配置后重新提交作业，如果不再出现ORA-01882错误，说明问题已解决。如果还有问题，可以检查Oracle数据库的时区设置（执行SELECT dbtimezone FROM dual;），确保和Spark的时区配置一致。

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