ORA-12514错误本质是监听器未注册或无法识别请求的服务名,核心在于服务注册不匹配:需检查lsnrctl status确认服务名是否存在且一致、local_listener配置是否正确、listener.ora中SID_LIST静态注册项是否准确、HOST值在tnsnames.ora与listener.ora中是否一致,以及PDB场景下service_names是否包含目标服务并已注册。

ORA-12514 不是数据库没启动、也不是网络不通——tnsping 能通,sqlplus / as sysdba 能进库,但远程一连就报错,说明监听器进程活着,只是“不认识”你填的那个 SERVICE_NAME 或 SID。核心问题永远在注册:要么根本没注册上,要么注册的名字对不上。
lsnrctl status 里看不到你的服务名?先确认注册方式
执行 lsnrctl status,重点看输出中 “Services Summary” 下有没有你客户端连接串里写的那个名字(比如 orcl、orclpdb 或 ORCL.localdomain)。没有,说明注册失败或未发生。
- 如果输出里只有
XE、CLREXT或空行,大概率是动态注册没生效:检查show parameter local_listener是否指向监听器实际监听的地址和端口(别写localhost而监听器绑的是真实 IP) - 如果输出里有服务,但名字和你连的不一致(比如你连
orcl,它显示orcl.localdomain),那是GLOBAL_DBNAME和service_names混用了——静态注册只认db_name+db_domain拼出的全局名,不认service_names - 如果用了 PDB,
instance_name是CDB$ROOT,但你要连的是orclpdb,那必须确保service_names包含该 PDB 服务名,且 PMON 已完成注册(可执行alter system register强制触发)
listener.ora 中 SID_NAME 和 GLOBAL_DBNAME 写反了?
静态注册靠 listener.ora 中的 SID_LIST_LISTENER,这里填错一个字就白配。常见翻车点:
-
SID_NAME填的是ORCL,但实际SELECT instance_name FROM v$instance返回orclpdb(PDB 场景下实例名 ≠ 服务名) -
GLOBAL_DBNAME写成ORCL,而数据库db_name是orcl、db_domain是localdomain,正确值应为orcl.localdomain - 把
service_names的值(如hr_svc)直接抄进GLOBAL_DBNAME——静态注册不认这个参数
验证方法:改完 listener.ora 后必须执行 lsnrctl reload 或 lsnrctl stop && lsnrctl start,再跑一次 lsnrctl status 确认服务名出现在 Services Summary 里。
tnsnames.ora 和 listener.ora 的 HOST 值不一致?
客户端能连上监听器,不代表监听器能跟数据库实例通信。两个配置文件里的 HOST 必须能互相解析:
-
listener.ora中(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.8.13)(PORT=1521))→ 监听器监听这个 IP -
tnsnames.ora中(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.8.13)(PORT=1521))→ 客户端往这个 IP 发请求 - 若监听器监听
localhost,而客户端连的是服务器 IP,即使服务名对也会被拒绝(尤其 Windows 默认只监听localhost)
.NET 或 Python(cx_Oracle)连接时 SERVICE_NAME 大小写/域名不匹配
show parameter service_names 和 lsnrctl status 输出的服务名必须逐字符一致,包括大小写、点号、域名后缀:
- 如果
lsnrctl status显示Service "prod_app.us.example.com",连接字符串里就不能写prod_app或PROD_APP.US.EXAMPLE.COM - Linux/Unix 下严格区分大小写;Windows 虽宽松,但建议统一用大写避免跨平台问题
- 连接字符串中若含
(DESCRIPTION=片段,优先级高于TNS_ADMIN,此时tnsnames.ora完全不参与解析 - 使用
tnsping your_service_name可验证解析路径是否命中预期配置
动态注册有延迟(PMON 默认每 60 秒广播一次),刚重启数据库后立刻连,lsnrctl status 可能还没刷出服务名——别急着重启,先等半分钟或手动触发 alter system register。











