cx_Oracle连接AWS RDS Oracle报ORA-12154但SQLPlus正常如何解决

你的问题属于cx_Oracle驱动未正确加载本机Oracle客户端配置、或连接字符串格式不符合驱动要求导致的，可按以下步骤依次排查：

1. 修正连接字符串格式 #

AWS RDS Oracle默认端口为1521，你当前使用的简易连接串未显式指定端口，cx_Oracle对连接格式的校验比SQLPlus更严格，推荐使用makedsn方法生成标准DSN，避免字符串拼接出错：

import cx_Oracle

# 生成标准DSN：参数依次为RDS实例地址、端口、服务名
dsn = cx_Oracle.makedsn(
    host='XXX.rds.amazonaws.com',
    port=1521,
    service_name='orcl'
)
# 分开传入账号密码参数，避免特殊字符被误解析
connection = cx_Oracle.connect(
    user='XXX',
    password='XXXX',
    dsn=dsn,
    encoding="UTF-8"
)

2. 显式指定Oracle客户端路径 #

SQLPlus能正常连接说明本机Oracle客户端配置有效，cx_Oracle默认搜索路径可能未匹配到该客户端，可在代码初始化阶段显式指定客户端路径：

• 先找到你本地SQLPlus对应的Oracle客户端根目录，例如C:\instantclient_19_3
• 在导入cx_Oracle后第一行添加初始化代码：

import cx_Oracle
# 替换为你本机的Oracle客户端实际路径
cx_Oracle.init_oracle_client(lib_dir=r"C:\instantclient_19_3")

3. 校验环境变量配置 #

如果以上两步仍报错，检查系统环境变量配置：

• 确认PATH环境变量中包含你正在使用的Oracle客户端目录，且该目录优先级高于其他存在的Oracle客户端路径
• 若配置了TNS_ADMIN环境变量，确认其指向的tnsnames.ora文件中存在对应RDS实例的连接配置，也可直接使用tnsnames.ora中配置的别名作为dsn参数传入连接方法。

常见注意事项 #

如果你的数据库密码包含@、/等特殊字符，直接拼接连接字符串会导致连接标识符解析错误，分开传入user、password、dsn参数可完全避免该问题。

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