// Oracle 错误参考

ORA-12505: TNS: 监听程序不知道 SID

连接字符串里的 SID 监听器不认识。通常是把服务名当成了 SID 来传,尤其是在带 host:port:SID 的 JDBC URL 里。

错误代码
ORA-12505
类别
连接与登录
错误信息
TNS:listener does not currently know of SID given in connect descriptor

它的意思

连接描述符可以通过 SID 或某个数据库,按 SERVICE_NAME。ORA-12505 表示客户端使用了 SID,而监听器没有叫这个名字的实例。在多租户数据库中,PDB 只能通过服务名访问,因此把 PDB 名称当作 SID 用就会报这个错。

较新的版本的措辞是 Cannot connect to database. SID SID_value is not registered with the listener at host_port.

常见原因

  • 一个 JDBC URL,格式为 jdbc:oracle:thin:@host:port:NAME 形式(SID),适用于 NAME 实际上是服务名。
  • 将 PDB 名称用作 SID。
  • 实例已停机,因此未注册。

如何修复它

  1. 改为通过服务名连接。在 JDBC 中,使用斜杠形式。

    -- SID form (fails for a PDB):     jdbc:oracle:thin:@db-host:1521:salespdb
    -- service name form:              jdbc:oracle:thin:@//db-host:1521/salespdb
  2. 查看监听器掌握的信息,可用: lsnrctl status,并确保实例已启动。

相关错误

更多连接和登录错误

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

// 错误更少,修复更快

在 SQLly 中使用 Oracle

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