Linux环境Python使用cx_Oracle连接Oracle报ORA-01804错误

• 运行环境：Linux操作系统
• 依赖版本：Python 3.9.7、cx_Oracle 8.3.0
• 前置状态：已配置.bash_profile环境变量，sqlplus命令可正常连接Oracle数据库
• 异常表现：执行cx_Oracle.clientversion()时抛出如下错误：

DatabaseError: Error while trying to retrieve text for error ORA-01804

• 相关附件：

该错误本质是Oracle客户端初始化阶段加载时区数据文件失败，sqlplus能正常连接但cx_Oracle报错，通常由三类问题导致：

• 环境变量作用域不匹配：.bash_profile仅在交互式登录Shell场景下自动加载，如果Python进程是通过IDE、后台服务、非登录Shell启动，将无法继承.bash_profile中配置的ORACLE_HOME、LD_LIBRARY_PATH等变量，导致客户端找不到依赖资源。手动在终端执行sqlplus时处于登录Shell环境，因此可以正常读取配置。
• 文件权限不匹配：运行Python的用户对$ORACLE_HOME/oracore/zoneinfo/目录下的时区数据文件无读权限；若sqlplus配置了setuid位或使用高权限启动，可正常读取文件，普通权限启动的Python进程则会触发加载失败。
• 多版本客户端冲突：系统内存在多个版本的Oracle客户端，cx_Oracle加载客户端库时优先命中了其他版本的libclntsh.so，无法找到对应版本的时区文件；sqlplus通常硬绑定自身安装路径下的依赖库，因此不受多版本冲突影响。

按以下顺序逐步排查修复：

1. 校验Python进程的环境变量加载情况
   在Python脚本开头加入以下调试代码，确认进程实际拿到的环境变量和.bash_profile中配置一致：

   import os
   print("ORACLE_HOME:", os.environ.get("ORACLE_HOME"))
   print("LD_LIBRARY_PATH:", os.environ.get("LD_LIBRARY_PATH"))
   print("ORA_TZFILE:", os.environ.get("ORA_TZFILE"))
   

   若打印值为空或与配置不符：手动终端启动Python前先执行source ~/.bash_profile重载配置；若通过IDE、定时任务、后台服务启动Python，需在对应启动配置项中显式添加Oracle相关环境变量，不要依赖.bash_profile的自动加载逻辑。
2. 校验时区文件权限
   执行命令ls -l $ORACLE_HOME/oracore/zoneinfo/查看目录权限，确认运行Python的用户对目录下所有文件有读权限，权限不足时执行chmod -R o+r $ORACLE_HOME/oracore/zoneinfo/添加全局读权限即可。
3. 校验客户端库加载路径
   执行以下命令查看cx_Oracle实际链接的Oracle客户端库路径：

   ldd $(python -c "import cx_Oracle; print(cx_Oracle.__file__)") | grep libclntsh
   

   若输出的libclntsh.so路径不属于你配置的ORACLE_HOME目录，说明存在多版本冲突：调整LD_LIBRARY_PATH顺序，将目标Oracle客户端的lib目录放到最靠前的优先级；也可以直接在代码中显式指定客户端路径，跳过环境变量查找逻辑：

   import cx_Oracle
   cx_Oracle.init_oracle_client(lib_dir="/opt/oracle/instantclient_19_8") # 替换为实际客户端lib目录绝对路径
   

4. 自定义时区变量校验
   若配置了ORA_TZFILE环境变量，确认该变量指向的时区文件路径真实存在、权限正常；无自定义时区需求时可直接取消该变量设置，使用Oracle客户端默认的时区文件即可。

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