Django连接Oracle12C遇ORA-01017错误求助

我之前也踩过类似的坑！既然Python脚本和JDBC都能正常连上TESTDB，那核心的用户名、密码和数据库实例肯定没问题，问题大概率出在Django配置的细节或者Oracle客户端与Django的适配环节上，咱们一步步来排查：

这是最容易出问题的地方，尤其是一些容易忽略的小细节：

• 特殊字符密码的处理：如果你的密码里包含@、$、&这类特殊字符，直接写在PASSWORD字段里没问题，但如果用URL格式的数据库配置（比如'default': 'oracle://user:pass@host:port/db'），必须对特殊字符做URL编码，比如@要换成%40，否则会被解析器误判。
• SID/服务名的匹配：Oracle的SID和服务名是两回事！检查settings里的NAME字段：如果tnsnames.ora里用的是SERVICE_NAME = TESTDB，那Django里的NAME就得写这个服务名；如果用的是SID，就写SID。另外，也可以直接把tnsnames里的别名作为NAME值（比如NAME='TESTDB'），但前提是Oracle客户端能找到tnsnames.ora文件。
• 大小写敏感问题：如果你的数据库用户是用双引号创建的（比如CREATE USER "TestUser" IDENTIFIED BY "Pass123"），那Django里的用户名和密码必须严格匹配大小写，不能随便小写或大写。

Python和JDBC能连，不代表Django运行时能拿到正确的环境变量：

• 客户端版本匹配：Django的Oracle后端依赖cx_Oracle，要确保cx_Oracle绑定的Oracle Instant Client版本和你Python/JDBC用的一致，版本不匹配可能会导致认证异常。
• 环境变量加载：检查ORACLE_HOME、LD_LIBRARY_PATH（Linux）或PATH（Windows）是不是指向正确的Oracle客户端目录？如果是在IDE里运行runserver，IDE的环境变量可能和终端不一样——终端里Python能连，但IDE里没加载到这些变量，就会出问题。另外，别忘了设置TNS_ADMIN环境变量指向tnsnames.ora所在的目录，确保客户端能找到配置文件。

虽然Python和JDBC能连，但还是快速确认下这两个文件的细节：

• listener.ora：确保监听的端口、主机和数据库实例对应，SID_LIST_LISTENER里有没有包含TESTDB的条目？比如：

  LISTENER =
    (DESCRIPTION_LIST =
      (DESCRIPTION =
        (ADDRESS = (PROTOCOL = TCP)(HOST = your-server-ip)(PORT = 1521))
      )
    )
  SID_LIST_LISTENER =
    (SID_LIST =
      (SID_DESC =
        (GLOBAL_DBNAME = TESTDB)
        (ORACLE_HOME = /path/to/oracle/home)
        (SID_NAME = TESTDB)
      )
    )
  

• tnsnames.ora：确认配置里的SERVICE_NAME或SID和数据库实际的一致，比如：

  TESTDB =
    (DESCRIPTION =
      (ADDRESS = (PROTOCOL = TCP)(HOST = your-server-ip)(PORT = 1521))
      (CONNECT_DATA =
        (SERVER = DEDICATED)
        (SERVICE_NAME = TESTDB)
      )
    )
  

既然Django的Oracle后端基于cx_Oracle，咱们可以写个小脚本直接验证：

import cx_Oracle
from django.conf import settings

# 直接从settings里取配置
username = settings.DATABASES['default']['USER']
password = settings.DATABASES['default']['PASSWORD']
dsn = settings.DATABASES['default']['NAME']

try:
    conn = cx_Oracle.connect(username, password, dsn)
    print("✅ cx_Oracle连接成功！")
    conn.close()
except cx_Oracle.Error as e:
    print(f"❌ cx_Oracle连接失败：{e}")

如果这个脚本报错，那问题就在cx_Oracle和Oracle客户端的交互上；如果能成功，那可能是Django Oracle后端的特殊配置问题（比如有没有开启额外的认证参数）。

• 虽然ORA-01017是认证错误，但如果实在找不到原因，可以确认下数据库用户的权限——比如Django需要的CREATE TABLE、SELECT系统表等权限有没有被授予？不过这个概率很低，毕竟Python能连的话基本权限应该没问题。
• 有没有开启Oracle的节点验证？比如listener.ora里设置了VALID_NODE_CHECKING_REGISTRATION=ON，但Django运行的主机不在允许列表里？不过Python和JDBC能连的话，这个也不太可能。

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