// Oracle 错误参考

ORA-12154: TNS: 无法解析连接标识符

Oracle 客户端无法把你连接时所用的名称解析成数据库地址:别名不在 tnsnames.ora 里,或者客户端读取的是另一个文件。

错误代码
ORA-12154
类别
连接与登录
错误信息
TNS:could not resolve the connect identifier specified

它的意思

当你用网络服务名连接时,比如 SALES,Oracle 客户端会通过它的命名方法查找该名称,通常是 tnsnames.ora。ORA-12154 表示它找不到这个名称。此时根本不会去连数据库,所以问题不在这台服务器。

较新的版本的措辞是 Cannot connect to database. Cannot find alias alias_value in repository_loc.,它还会说明客户端是在哪里查找的。

常见原因

  • 别名未在 tnsnames.ora 它和客户端实际读取的名称不符,或者就是拼写错误。
  • TNS_ADMIN 指向另一个目录,或者每个 Oracle 主目录都有自己的 tnsnames.ora.
  • 语法错误,位于 tnsnames.ora,例如括号不匹配,导致条目无法读取。
  • sqlnet.ora 限制命名方法(NAMES.DIRECTORY_PATH),所以 tnsnames.ora 就不会被读取。
  • 域名会附加到名称后面,来源是 NAMES.DEFAULT_DOMAIN 而且条目没有它。

如何修复它

  1. 跳过别名,直接使用 Easy Connect 连接,无需任何 tnsnames.ora: sqlplus app_user@//db-host:1521/salespdb.

  2. 检查客户端使用哪个文件:运行 tnsping SALES,它会把读到的参数文件以及名称的解析方式打印出来。

  3. 在该文件中添加或修复条目。

    SALES =
      (DESCRIPTION =
        (ADDRESS = (PROTOCOL = TCP)(HOST = db-host)(PORT = 1521))
        (CONNECT_DATA = (SERVICE_NAME = salespdb)))
  4. 设置 TNS_ADMIN 设置为包含正确的目录 tnsnames.ora 和 sqlnet.ora.

相关错误

更多连接和登录错误

代码和消息文本来自 Oracle 数据库错误帮助。浏览完整的 Oracle 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 Oracle

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 Oracle 以及你使用的其他数据库。