深入解析与解决：Oracle 监听器 TNS-12560: TNS: 协议适配器错误 (ORA-01067)

目录#

错误理解
- 1.1 错误信息展示
- 1.2 错误核心原因分析
系统化故障排除指南
- 2.1 第一步：基础环境检查
- 2.2 第二步：Oracle 环境变量检查
- 2.3 第三步：监听器状态检查与诊断
- 2.4 第四步：实例状态与参数文件检查
- 2.5 第五步：网络配置检查
常见场景与解决方案
- 场景一：ORACLE_SID 设置错误或不一致
- 场景二：监听器未启动或配置错误
- 场景三：参数文件（pfile/spfile）问题
- 场景四：权限问题
最佳实践与预防措施
总结
参考

1. 错误理解#

1.1 错误信息展示#

当你通过 SQL*Plus 连接数据库时，通常会看到如下错误组合：

$ sqlplus / as sysdba
 
SQL*Plus: Release 19.0.0.0.0 - Production on Tue Oct 24 10:00:00 2023
Version 19.3.0.0.0
 
Copyright (c) 1982, 2019, Oracle.  All rights reserved.
 
ERROR:
ORA-01034: ORACLE not available
ORA-27101: shared memory realm does not exist
01067: ORACLE not available
Process ID: 0
Session ID: 0 Serial number: 0

或者，在尝试启动实例时：

SQL> STARTUP
ORA-01078: failure in processing system parameters
LRM-00109: could not open parameter file '/u01/app/oracle/product/19.0.0/dbhome_1/dbs/initorcl.ora'

虽然直接报 TNS-12560 的情况在服务端启动时较少见（它更多出现在客户端连接时），但 ORA-01067 的本质是数据库实例无法正常启动或初始化，这通常是问题的核心。

1.2 错误核心原因分析#

“协议适配器错误”是一个比较宽泛的描述。简单来说，它表示 Oracle 的某个组件（如数据库实例或监听器）在尝试使用特定的网络协议进行通信时失败了。对于 STARTUP 命令而言，失败点通常发生在实例启动的初期阶段。主要原因可以归结为以下几类：

环境问题：操作系统环境变量（特别是 ORACLE_SID）设置不正确。
文件缺失或损坏：关键的启动文件（如参数文件 pfile/spfile、密码文件）丢失或内容错误。
进程问题：监听器进程（LSNRCTL）未运行或配置错误。
权限问题：Oracle 软件安装所有者（通常是 oracle 用户）没有足够的权限访问相关文件或目录。
资源冲突：端口被占用，或内存等系统资源不足。

2. 系统化故障排除指南#

遵循以下步骤，可以高效地定位并解决问题。

2.1 第一步：基础环境检查#

操作：确认你当前的操作系统用户和数据库实例状态。

检查当前用户：确保你使用的是安装 Oracle 软件的用户（在 Linux/Unix 上通常是 oracle）。
```
$ whoami
oracle
```
检查实例进程：查看是否有相关的 Oracle 进程正在运行。
```
$ ps -ef | grep pmon
oracle   12345     1  0 09:00 ?        00:00:00 ora_pmon_ORCL
```
- 如果 pmon（进程监控进程）存在，说明实例可能已经启动。
- 如果没有任何输出，说明实例确实没有运行。

2.2 第二步：Oracle 环境变量检查#

操作：验证 ORACLE_SID 和 ORACLE_HOME 环境变量是否正确设置。

查看环境变量：
```
$ echo $ORACLE_SID
ORCL
$ echo $ORACLE_HOME
/u01/app/oracle/product/19.0.0/dbhome_1
```
- 关键点：ORACLE_SID 必须与你要启动的数据库实例的名称完全一致（区分大小写）。
设置环境变量（如需要）：在 Linux/Unix 的 oracle 用户 profile 文件（如 ~/.bash_profile）中设置。
```
export ORACLE_SID=ORCL
export ORACLE_HOME=/u01/app/oracle/product/19.0.0/dbhome_1
export PATH=$ORACLE_HOME/bin:$PATH
```
设置后，执行 source ~/.bash_profile 使其生效。

2.3 第三步：监听器状态检查与诊断#

操作：即使 STARTUP 是实例启动，一个健康的监听器环境也是诊断的重要部分。使用 lsnrctl 命令。

检查监听器状态：

$ lsnrctl status
 
LSNRCTL for Linux: Version 19.0.0.0.0 - Production on 24-OCT-2023 10:05:00
 
Copyright (c) 1991, 2019, Oracle.  All rights reserved.
 
Connecting to (DESCRIPTION=(ADDRESS=(PROTOCOL=IPC)(KEY=EXTPROC1521)))
STATUS of the LISTENER
------------------------
Alias                     LISTENER
Version                   TNSLSNR for Linux: Version 19.0.0.0.0 - Production
Start Date                24-OCT-2023 09:01:00
Uptime                    0 days 1 hr. 4 min. 0 sec
Trace Level               off
Security                  ON: Local OS Authentication
SNMP                      OFF
Listener Parameter File   /u01/app/oracle/product/19.0.0/dbhome_1/network/admin/listener.ora
Listener Log File         /u01/app/oracle/diag/tnslsnr/hostname/listener/alert/log.xml
Listening Endpoints Summary...
  (DESCRIPTION=(ADDRESS=(PROTOCOL=ipc)(KEY=EXTPROC1521)))
  (DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=hostname)(PORT=1521)))
The listener supports no services

注意最后一行：”The listener supports no services”。这是正常的，因为此时实例未启动。一旦实例启动并注册，服务名会出现在这里。

启动监听器（如果需要）：
```
$ lsnrctl start
```

2.4 第四步：实例状态与参数文件检查#

这是最关键的一步。STARTUP 命令失败大多与此相关。

尝试无参数启动（用于诊断）：这种方式会使用默认路径和文件名查找参数文件。
```
SQL> STARTUP NOMOUNT;
```
- 如果成功，说明 ORACLE_SID 和最基本的二进制文件没问题，问题可能出在参数文件内容或控制文件上。
- 如果失败，通常会给出明确的错误信息，例如找不到参数文件。
指定参数文件启动：如果 STARTUP NOMOUNT 失败并提示找不到参数文件，你可以显式指定一个。
- 使用 PFILE：
```
SQL> STARTUP PFILE=‘/u01/app/oracle/product/19.0.0/dbhome_1/dbs/initORCL.ora’;
```
- 使用 SPFILE：
```
SQL> STARTUP SPFILE=‘/u01/app/oracle/product/19.0.0/dbhome_1/dbs/spfileORCL.ora’;
```
- 最佳实践：建议使用 SPFILE。你可以从 PFILE 创建 SPFILE：CREATE SPFILE FROM PFILE；。
检查参数文件路径和权限： Oracle 默认按以下顺序查找参数文件：
- spfile$ORACLE_SID.ora
- spfile.ora
- init$ORACLE_SID.ora 确保文件存在于 $ORACLE_HOME/dbs 目录下，并且 oracle 用户有读取权限。
```
$ ls -l $ORACLE_HOME/dbs/initORCL.ora
$ ls -l $ORACLE_HOME/dbs/spfileORCL.ora
```

2.5 第五步：网络配置检查#

操作：检查 listener.ora 和 sqlnet.ora 等网络配置文件。

检查 listener.ora：文件位于 $ORACLE_HOME/network/admin。确保其中的 HOST 设置正确（最好使用 IP 地址或正确解析的主机名）。

LISTENER =
  (DESCRIPTION_LIST =
    (DESCRIPTION =
      (ADDRESS = (PROTOCOL = TCP)(HOST = your_server_ip)(PORT = 1521))
    )
  )

检查 sqlnet.ora：检查认证方式等设置。一个常见的配置是：

SQLNET.AUTHENTICATION_SERVICES = (NTS)  # 在 Windows 上常用
NAMES.DIRECTORY_PATH= (TNSNAMES, EZCONNECT)

3. 常见场景与解决方案#

场景一：ORACLE_SID 设置错误或不一致#

症状：sqlplus / as sysdba 可以登录，但 STARTUP 失败报错。
解决方案：
1. 仔细检查 echo $ORACLE_SID 的输出。
2. 确保它与参数文件名（如 initORCL.ora 中的 ORCL）以及你意图启动的数据库实例名完全一致。
3. 使用 export ORACLE_SID=正确的SID 进行修正。

场景二：监听器未启动或配置错误#

症状：客户端连接时报 TNS-12560，但服务端 STARTUP 可能成功，只是无法远程连接。
解决方案：
1. 在服务器上执行 lsnrctl status 确认监听器运行。
2. 检查 listener.ora 中的 HOST 和 PORT 配置是否正确，且未被防火墙阻挡。
3. 重启监听器：lsnrctl stop 然后 lsnrctl start。

场景三：参数文件（pfile/spfile）问题#

症状：STARTUP 时直接报 ORA-01078。
解决方案：
1. 文件丢失：如果有备份，从备份恢复。否则，可能需要手动重建一个最简单的 pfile。
```
# 创建一个最基本的 pfile
$ echo "DB_NAME=ORCL" > $ORACLE_HOME/dbs/initORCL.ora
```
2. 文件内容错误：检查参数文件中的语法错误，特别是路径类参数（如 control_files）是否正确。
3. 从内存创建 PFILE：如果你之前成功启动过，并且使用的是 SPFILE，可以尝试从内存中获取参数来重建 PFILE。
```
SQL> CREATE PFILE=‘/tmp/initORCL.ora’ FROM MEMORY;
```

场景四：权限问题#

症状：各种操作失败，可能伴有 Permission denied 提示。
解决方案：
1. 确保 $ORACLE_HOME 目录及其下的 dbs、network 等子目录的权限属于 oracle 用户和其所属的组（如 oinstall）。
2. 检查 Oracle 的跟踪文件和日志目录（如 $ORACLE_BASE/diag）的权限。

4. 最佳实践与预防措施#

标准化环境配置：使用统一的脚本或工具（如 OraEnv）来设置 Oracle 环境变量，避免手动输入错误。
使用 SPFILE：SPFILE 存储在服务器上，不易被意外修改，且支持动态参数修改。
定期备份：定期备份参数文件（CREATE PFILE FROM SPFILE；）、控制文件和密码文件。这些文件虽小，但至关重要。
清晰的文档：记录数据库的 ORACLE_SID、端口号、重要文件路径等信息。
监控监听器：将监听器状态监控纳入日常运维检查清单。

5. 总结#

TNS-12560 / ORA-01067 错误虽然令人烦恼，但通过系统化的方法，绝大多数情况下都可以快速解决。解决问题的核心思路是：从外到内，从简单到复杂。

确认环境：用户、变量。
检查进程：实例、监听器。
验证文件：参数文件、权限。
分析网络：监听器配置、端口。

养成良好运维习惯，可以有效预防此类问题的发生。希望这篇详细的指南能成为你解决 Oracle 启动问题的得力助手。

目录#