cx_Oracle无法连接数据库——疑似TNSNAMES.ora配置问题

1. 确定cx_Oracle指向的TNSNAMES.ora文件 #

cx_Oracle依赖Oracle客户端的配置，查找其使用的TNS文件路径可按以下步骤操作：

• 检查TNS_ADMIN环境变量：这是Oracle客户端优先读取的配置路径。
  • 在Python中执行：

    import os
    print(os.environ.get('TNS_ADMIN'))
    

  • 系统终端验证：Windows输入set TNS_ADMIN，Linux/macOS输入echo $TNS_ADMIN。如果输出有效路径，cx_Oracle就使用该路径下的TNSNAMES.ora。
• 默认搜索路径：如果未设置TNS_ADMIN，Oracle客户端会按以下顺序查找：
  • Windows：Oracle客户端安装目录下的network\admin，例如C:\app\client\your_user\product\19.0.0\client_1\network\admin
  • Linux/macOS：$ORACLE_HOME/network/admin 或 /etc（系统级安装时）
• 手动指定验证：在Python代码开头添加cx_Oracle.init_oracle_client(config_dir='<你的TNS文件所在目录>')，如果能正常连接，说明该目录下的文件是cx_Oracle需要的。

2. 必要的额外配置 #

• 配置TNS_ADMIN环境变量：如果SQL Developer使用的TNS文件不在cx_Oracle的默认路径中，直接设置系统环境变量TNS_ADMIN指向该文件所在目录，重启Python环境后生效。
• 验证TNSNAMES.ora格式：确保别名配置无语法错误，示例正确格式：

  YOUR_ALIAS =
    (DESCRIPTION =
      (ADDRESS = (PROTOCOL = TCP)(HOST = db_host)(PORT = 1521))
      (CONNECT_DATA =
        (SERVER = DEDICATED)
        (SERVICE_NAME = your_service)
      )
    )
  

• 绕开TNS文件测试：用Easy Connect字符串替代TNS别名，直接验证连接是否正常：

  dsn = "db_host:1521/your_service"
  con = cx_Oracle.connect(user=user, password=password, dsn=dsn)
  

  如果能连接，说明TNS文件配置或路径存在问题；如果仍报错，检查账号权限、网络连通性。

3. 64位兼容性问题排查 #

位数不匹配是ORA-12154的常见诱因，必须保证以下组件位数完全一致：

• Python：执行import sys; print(sys.maxsize > 2**32)，返回True为64位，False为32位。
• cx_Oracle：pip安装时会自动匹配Python位数，也可通过pip show cx_Oracle查看安装包信息确认。
• Oracle客户端：Windows下看安装目录（Program Files对应64位，Program Files (x86)对应32位）；Linux/macOS下执行file $ORACLE_HOME/bin/sqlplus，输出含x86_64为64位，i386为32位。
• 若组件位数不匹配，卸载对应位数的cx_Oracle或Oracle客户端，安装与Python一致的版本即可。

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