讲师中心 微信公众号
AI工具推荐 视频效率加速

如何修复Oracle 11g Data Guard中的TNS-12154连接描述符错误

秋丽姑娘_8429

秋丽姑娘_8429

发布时间:2026-06-23 09:59:04

|

777人浏览过

|

来源于php中文网

原创

ORA-12154在Data Guard中本质是备库侧TNS解析失败,主因是ARC进程未正确加载tnsnames.ora:TNS_ADMIN未设置或路径错误、instant client不默认加载、RAC下文件位置不统一;需用tnsping std验证别名解析,且log_archive_dest_2必须使用严格匹配的service别名而非Easy Connect格式。

ora-12154 在 data guard 环境中不是配置错,而是解析链断在了备库侧 —— 主库能连、tnsping 通、监听正常,但 arc 进程持续报错,说明问题出在备库的 tns 解析上下文里。

备库上 tnsnames.ora 被忽略的三个真实原因

主库和备库共用一套监听器配置,但客户端(比如归档进程 ARC)在备库启动时,并不默认读取 $ORACLE_HOME/network/admin/tnsnames.ora。常见触发点:

  • TNS_ADMIN 环境变量未在备库的 Oracle 用户 shell 中设置,或指向了空目录/错误路径
  • 备库启动时使用的是 ORACLE_HOME 下的 instant client,而非 full client;instant client 默认不加载 tnsnames.ora,除非显式指定 TNS_ADMIN
  • 备库运行在 RAC 或 ASM 环境下,$ORACLE_HOME 实际指向 Grid Infrastructure 的 home,而 tnsnames.ora 却放在 Database home 的 network/admin 目录下

验证 ARC 是否真在用你认为的那个 tnsnames.ora

别信“文件存在就一定被读”,ARC 进程有自己的执行环境。直接在备库上以 Oracle 用户身份执行:

echo $TNS_ADMIN
ls -l $TNS_ADMIN/tnsnames.ora 2>/dev/null || echo "no tnsnames.ora found"
tnsping std  # 注意:这里必须用你在主库 <code>log_archive_dest_2</code> 中配置的 <code>service_name</code> 别名,比如 std

如果 tnsping 报 ORA-12154,但 ls 显示文件存在,说明:

  • 要么 TNS_ADMIN 指向了错误目录(比如指向了主库的路径)
  • 要么 tnsnames.ora 中定义的别名(如 std)拼写与 log_archive_dest_2 中的 service 名不一致(大小写、空格、换行都算)
  • 要么该文件权限为 600 且属主不是 Oracle 用户(Linux/Unix 下非属主不可读)

log_archive_dest_2 配置中 service 名必须匹配别名,不能是 IP+端口+service_name

Data Guard 归档依赖 TNS 别名解析,不支持 Easy Connect 格式。以下写法必然失败:

LOG_ARCHIVE_DEST_2='SERVICE=192.168.1.10:1521/orcl_stby ASYNC VALID_FOR=(ONLINE_LOGFILES,PRIMARY_ROLE) DB_UNIQUE_NAME=orcl_stby'

正确写法只能是:

QuantOracle
QuantOracle

63个确定性量化金融计算器 + 10个通过MCP的复合工作流。期权定价、Greeks、奇异衍生品、风险指标、投资组合优化……

下载
LOG_ARCHIVE_DEST_2='SERVICE=std ASYNC VALID_FOR=(ONLINE_LOGFILES,PRIMARY_ROLE) DB_UNIQUE_NAME=orcl_stby'

其中 std 必须严格对应 tnsnames.ora 中的条目名,且该条目必须包含完整 (DESCRIPTION=...) 结构,不能省略 CONNECT_DATA 块。

备库监听器注册状态常被误判

即使 lsnrctl status 显示监听器运行,也不代表备库实例已注册服务。尤其在 Active Data Guard 或只读打开状态下,PMON 不会向监听器注册服务名(这是设计行为)。但 ARC 进程连接主库时,不需要备库监听器注册 —— 它只 outbound 连主库。真正要检查的是:

  • 主库监听器是否注册了备库的 service 名(用于主库反向连接?不,Data Guard 不需要)→ 其实不需要
  • 备库监听器是否监听了本地 LOCAL_LISTENER 地址(影响本地 SQL*Plus 连接,但不影响 ARC)→ 无关
  • 唯一关键点:备库能否用 tnsping std 解析到主库地址 → 这才是 ARC 所依赖的全部

所以重点永远在备库的 TNS_ADMIN + tnsnames.ora + 别名一致性,而不是监听器状态本身。

最易被忽略的点:RAC 环境下,tnsnames.ora 必须放在所有节点统一可访问的位置(如 ACFS 或 NFS),且每个节点的 TNS_ADMIN 必须指向同一路径;否则某节点 ARC 启动失败,日志里只报 ORA-12154,不会提示“找不到配置文件”。

热门AI工具

更多
切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

相关专题

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

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

1001

2023.08.16

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

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

2933

2023.09.15

oracle怎么分页
oracle怎么分页

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

2930

2023.09.18

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

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

1669

2023.09.19

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

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

2293

2023.09.19

oracle imp
oracle imp

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

3109

2023.09.19

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

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

4569

2023.11.02

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

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

237

2023.11.08

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn