Python执行SQL报ORA-01805日期时间操作错误如何解决

这个报错和你安装的Instant Client版本新旧没有直接关系，核心诱因是客户端与数据库服务端的日期解析规则、时区配置不匹配，或是SQL中日期值的写法不符合Oracle当前的解析逻辑，按以下步骤调整即可解决：

• 连接建立后显式设置会话级日期参数
  不要依赖数据库或客户端的默认NLS配置，在成功建立Oracle连接、创建游标后，第一时间执行会话参数调整，统一日期、时间戳的解析格式与时区：

  # 游标创建后立刻执行以下语句，时区可按实际业务场景替换
  cursor.execute("ALTER SESSION SET NLS_DATE_FORMAT = 'YYYY-MM-DD HH24:MI:SS'")
  cursor.execute("ALTER SESSION SET NLS_TIMESTAMP_FORMAT = 'YYYY-MM-DD HH24:MI:SS.FF'")
  cursor.execute("ALTER SESSION SET NLS_TIMESTAMP_TZ_FORMAT = 'YYYY-MM-DD HH24:MI:SS.FF TZH:TZM'")
  cursor.execute("ALTER SESSION SET TIME_ZONE = '+08:00'")
  

• 所有日期值传参改用绑定方式，禁止硬编码拼接日期字符串
  直接在SQL里拼接字符串格式的日期，会完全依赖Oracle当前的默认格式配置，稍有配置差异就会触发解析错误，统一用参数绑定传入datetime类型对象，由驱动层自动完成类型适配：

  错误写法（高风险）

  # 硬拼接日期字符串，极易触发格式不匹配
  query_sql = "SELECT * FROM log WHERE op_time > '2024-01-01 00:00:00'"
  cursor.execute(query_sql)
  

  正确写法

  from datetime import datetime
  query_sql = "SELECT * FROM log WHERE op_time > :op_time"
  # 直接传入datetime类型对象，无需手动转字符串
  cursor.execute(query_sql, op_time=datetime(2024, 1, 1, 0, 0, 0))
  

• 检查SQL中日期转换函数的写法
  如果SQL中用到TO_DATE、TO_TIMESTAMP类转换函数，必须显式传入第二个格式参数，不能省略格式让Oracle用默认规则解析：

  -- 错误写法：依赖默认NLS配置，稳定性差
  SELECT TO_DATE('2024-06-01') FROM DUAL;
  
  -- 正确写法：显式指定解析格式
  SELECT TO_DATE('2024-06-01', 'YYYY-MM-DD') FROM DUAL;
  

• 排查客户端版本加载冲突
  如果以上操作后报错仍存在，执行以下代码确认当前Python环境实际加载的Oracle客户端版本：

  # 若使用旧版cx_Oracle，替换为import cx_Oracle as oracledb即可
  import oracledb
  print(oracledb.clientversion())
  

  如果打印的版本不是你刚安装的最新版，说明系统环境变量里存在旧版Oracle客户端路径优先级更高的问题，将旧版本路径从系统PATH变量中移除，把最新版Instant Client的路径调整到PATH最前端，重启Python运行环境后重试即可。

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