如何排查ORA-12514报错_监听程序当前无法识别连接描述符

夜枫酱_1572

夜枫酱_1572

2026-03-26

665人浏览

原创

ORA-12514的本质是监听器未识别所连服务名,需通过lsnrctl services确认服务名是否存在、检查数据库OPEN状态、核对listener.ora静态注册、service_names参数及客户端连接串大小写与域名一致性。

确认监听器是否知道你要连的服务名

ora-12514 的本质不是“连不上”,而是“监听器压根不认识你写的 service_name 或 sid”。它收到了请求,但查了一遍自己登记的名单,没找到匹配项。

最直接的验证方式是登录数据库服务器,运行:
lsnrctl services
看输出里有没有你连接串中指定的那个服务名(比如 orcl、orcl.example.com、PDB1)。没有?那就不是网络或密码问题,而是注册没成功或配错了。

  • 如果输出里只有 PLSExtProc 或空空如也,说明数据库实例根本没注册上来——先检查数据库是否真的 OPEN 状态(select status from v$instance;)
  • 如果服务名存在但大小写/域名不一致(比如 tnsnames.ora 里写 SERVICE_NAME = orcl,而 lsnrctl services 显示的是 ORCL.example.com),就属于典型拼写或域配置不匹配
  • Oracle 12c+ 多租户环境下,注意区分 CDB 名和 PDB 名:连接 PDB 必须用其专属服务名(通常是创建时指定的),不能直接用 CDB 的 SID

检查 listener.ora 是否静态注册了对应实例

动态注册靠数据库自己“主动报到”,但有时启动慢、防火墙拦截、或数据库异常退出后没重注册,就会掉线。这时得靠 listener.ora 里的静态注册兜底。

打开 $ORACLE_HOME/network/admin/listener.ora,确认是否存在类似这样的块:

SID_LIST_LISTENER =
  (SID_LIST =
    (SID_DESC =
      (GLOBAL_DBNAME = orcl)
      (ORACLE_HOME = /u01/app/oracle/product/19c/dbhome_1)
      (SID_NAME = orcl)
    )
  )
  • GLOBAL_DBNAME 值必须和你的连接串中 SERVICE_NAME 完全一致(包括大小写和域名)
  • SID_NAME 是实例名(select instance_name from v$instance; 查),通常和 GLOBAL_DBNAME 相同,但 RAC 或自定义场景可能不同
  • 改完必须执行 lsnrctl reload 或 lsnrctl stop && lsnrctl start,只改文件不重启监听器=白改
  • 别漏掉已有的 PLSExtProc 条目,删掉它可能导致外部过程调用失败

核对客户端连接串和服务端实际服务名是否对齐

很多人卡在“我明明写了 orcl,为什么还报错”——因为 tnsnames.ora、Easy Connect 字符串、JDBC URL 三者之一写错了,或者数据库本身服务名不是你以为的那样。

  • 查真实服务名:sqlplus / as sysdba → show parameter service_names(返回值可能是一组,用逗号分隔)
  • tnsnames.ora 中的 SERVICE_NAME 必须精确匹配上面查出的某一个;若用 SID 连(CONNECT_DATA = (SID = orcl)),则监听器必须有对应 SID_NAME 静态注册
  • JDBC URL 如 jdbc:oracle:thin:@host:1521/orcl,末尾的 /orcl 是服务名,:1521:orcl 才是 SID 模式——别混用
  • 云数据库(如 Oracle Cloud ATP/ADB)默认禁用 SID 连接,只认服务名,且服务名带特定后缀(如 db2026_medium.adwc.oraclecloud.com),硬写 orcl 必错

别忽略“刚启库就去连”这个时间窗口

数据库实例启动后,要花几秒到十几秒向监听器发起动态注册。这期间连,大概率撞上 ORA-12514——不是故障,是竞态。

  • 启动数据库后,等 10–15 秒再试连接,或轮询 lsnrctl services | grep -i your_service_name
  • 如果频繁遇到,说明注册延迟异常,可检查 local_listener 参数是否指向正确地址(show parameter local_listener),尤其在多网卡或容器环境中容易配错
  • 生产环境建议加监控:用脚本定期查 lsnrctl status + lsnrctl services 输出,比单纯 ping 端口靠谱得多

最容易被跳过的点:以为改了 tnsnames.ora 就万事大吉,却忘了服务器上 listener.ora 没配、数据库没启、或者服务名大小写敏感——三个地方,一个不一致,就卡在这儿。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
oracle清空表数据
oracle清空表数据

当表中的数据不需要时,则应该删除该数据并释放所占用的空间。本专题为大家提供oracle清空表数据的相关文章,帮助大家解决该问题。

2023.08.16

961

5

Oracle中declare的使用
Oracle中declare的使用

Oracle DECLARE语句是PL/SQL编程语言中用于声明变量、常量、游标或异常的关键字。它的主要作用是在程序中定义这些对象,以便在后续的代码中使用。DECLARE语句的语法简单明了,可以根据需要声明多个对象。通过使用这些声明的对象,可以进行各种操作,如计算、查询数据库、处理异常等 。

2023.09.15

2753

5

oracle怎么分页
oracle怎么分页

实现分页的步骤:1、使用ROWNUM进行分页查询;2、在执行查询之前进行设置分页参数;3、使用"COUNT(*)"函数来获取总行数,并使用"CEIL"函数来向上取整计算总页数;4、在外部查询中使用"WHERE"子句来筛选出特定的行号范围,以实现分页查询。想了解更多oracle怎么分页的文章,可以来阅读本专题先的文章。

2023.09.18

2790

5

Oracle查看表操作历史记录
Oracle查看表操作历史记录

查看操作历史记录的方法:1、使用Oracle内置的审计功能,可以记录数据库中发生的各种操作,包括登录、DDL语句、DML语句等;2、使用Oracle日志文件,其中包含了数据库中发生的各种操作,可以通过查看日志文件来获取操作历史记录;3、使用Oracle的Flashback功能,可以查看数据库在某个时间点的操作历史记录;4、使用第三方工具等。本专题还提供其他查看表操作的文章,大家可以免费阅读。

2023.09.19

1589

3

Oracle中RAC的用法
Oracle中RAC的用法

Oracle中RAC的用法:1、通过在多个服务器上运行数据库实例来提供高可用性;2、允许在需要时增加或减少节点数量;3、通过将工作负载分布到多个节点上来实现负载均衡;4、使用共享存储来实现多个节点之间的数据共享;5、允许多个节点同时处理数据库请求,从而实现并行处理;6、提供了透明故障切换功能;7、使用了一些技术来确保数据的一致性;8、提供了管理工具来简化RAC环境的管理和维护。本专题还提供RAC相关的其他文章,大家可以免费阅读。

2023.09.19

2213

7

oracle imp
oracle imp

imp是Oracle数据库中的一个命令行工具,用于将导出的数据和对象从一个数据库实例导入到另一个数据库实例。imp命令的一般语法为“imp username/password@connect_string file=file_name [options]”。

2023.09.19

2949

4

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

4449

19

oracle通配符有哪些
oracle通配符有哪些

oracle通配符有“%”、“_”、“[]”和“[^]"。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.08

237

5

oracle四舍五入怎么操作
oracle四舍五入怎么操作

oracle四舍五入操作可以使用ROUND函数来实现,其语法为“ROUND(number, decimal_places)”,其中,number是要进行四舍五入的数值,decimal_places是指定的小数位数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.14

766

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.7万人学习