Django项目如何识别Oracle Instant Client解决连接报错

报错DPI-1047的本质是运行Django的64位Python进程，加载到了32位版本的oci.dll。
你之前单独使用cx_Oracle能正常连接，是因为当时运行环境优先读到了正确的64位客户端；但Django启动时加载Oracle驱动的时机更早，会自动按系统PATH的顺序搜索oci.dll，优先命中了C:\ProgramData\Oracle12c\product\12.1.0\client_1\bin路径下的32位dll，才触发架构不匹配错误。
Django本身的数据库配置项确实没有指定Oracle客户端路径的参数——这个配置逻辑归底层cx_Oracle驱动管控，不需要修改你现有的DATABASES配置，以下两个方案都可以直接解决问题：

这个方案不需要修改系统配置，只需要在Django加载数据库配置前，主动调用cx_Oracle的初始化方法指定64位客户端路径，稳定性最高：

• 先确认本地64位Oracle Instant Client的实际存放路径，确保路径下存在64位版本的oci.dll文件
• 打开项目的settings.py，在文件最顶部（所有Django相关导入、DATABASES配置之前）加入如下代码，将路径替换为你本地的实际客户端路径：

import cx_Oracle
# 替换为本地64位Oracle Instant Client的实际路径
cx_Oracle.init_oracle_client(lib_dir=r"D:\oracle\instantclient_19_15")

注意：init_oracle_client方法必须在第一次创建Oracle连接前调用，放在settings.py最顶部可以保证执行顺序正确，不会被提前加载的驱动抢占搜索逻辑。

如果不想修改项目代码，可以调整系统环境变量的搜索顺序，让64位客户端路径优先被识别：

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在系统变量列表中找到Path，点击编辑
• 将你本地64位Oracle Instant Client的完整路径，上移到所有Oracle相关路径的最顶部，排在报错提示的C:\ProgramData\Oracle12c\product\12.1.0\client_1\bin路径之前
• 保存修改后，重启所有打开的终端、IDE，确保新的环境变量生效后再启动Django服务
  注意：该方案会修改全局环境变量，如果本机有其他32位程序依赖旧的32位Oracle客户端，可能会导致这类程序运行异常，优先选择方案1。

配置完成后，你现有的双数据库配置、基于connections['oracleDB']的原生SQL查询逻辑不需要做任何修改，直接启动服务调用接口即可正常连接；账号的只读权限不会影响查询操作，可正常执行fetchall()获取结果。

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