Oracle 21c CDB使用SQL*Plus连接报错ORA-12154求助

创建了Oracle 21c CDB（实例名netcoolc），执行sqlplus sys/"PW"@netcoolc as sysdba时触发ORA-12154错误，但tnsping netcoolc正常返回，sqlplus / as sysdba可成功登录CDB$ROOT。相关配置如下：

.bash_profile环境变量：

# Oracle 21c netcool  Environment Variables - START
ORACLE_BASE=/opt/oracle; export ORACLE_BASE
ORACLE_HOME=${ORACLE_BASE}/product/21c/dbhome_1; export ORACLE_HOME
ORACLE_SID=netcoolc; export ORACLE_SID
PATH=$ORACLE_HOME/bin:$ORACLE_HOME/perl/bin:$PATH; export PATH
NLS_LANG=american_america.WE8ISO8859P1; export NLS_LANG
# Oracle 21c netcool Environment Variables - END

tnsnames.ora内容：

netcoolc =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = iqlinkxg02)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = netcoolc)
    )
  )

• 验证tnsnames.ora的实际读取路径
  tnsping和sqlplus可能读取不同路径的tnsnames.ora文件：

  1. 执行echo $TNS_ADMIN，确认是否指定了自定义的TNS配置路径；若未设置，Oracle默认读取$ORACLE_HOME/network/admin下的文件。
  2. 直接使用完整连接串测试登录：

     sqlplus sys/"PW"@'(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=iqlinkxg02)(PORT=1521))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=netcoolc)))' as sysdba
     

     若此命令能成功登录，说明当前sqlplus未读取到你配置的tnsnames.ora文件，需检查路径或TNS_ADMIN变量设置。

• 检查tnsnames.ora语法与服务名匹配性

  1. 排查文件是否存在隐藏字符（如多余空格、换行符），可将内容复制到新文件重新保存，避免格式问题。
  2. 登录本地CDB后执行show parameter service_name，确认数据库实际注册的服务名是否为netcoolc；若服务名不一致，需修改tnsnames.ora中的SERVICE_NAME字段。

• 确认SQL*Plus环境的正确性

  1. 执行which sqlplus和sqlplus -v，验证当前使用的是Oracle 21c版本的客户端，避免旧版本客户端导致的解析兼容问题。
  2. 检查环境变量是否存在冲突：执行env | grep ORACLE，确认无其他Oracle版本的ORACLE_HOME/PATH变量干扰。

• 处理密码特殊字符的shell转义问题
  若密码包含@、$、!等特殊字符，shell会自动解析这些字符导致密码传递错误：

  • 尝试用单引号包裹完整连接串：

    sqlplus 'sys/PW@netcoolc as sysdba'
    

  • 或直接将密码嵌入连接串：

    sqlplus sys@'(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=iqlinkxg02)(PORT=1521))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=netcoolc)(PASSWORD=PW)))' as sysdba
    

• 检查监听状态与服务注册情况
  tnsping仅测试监听可达性，不验证服务是否注册：

  1. 执行lsnrctl status，查看监听是否已注册netcoolc服务；若未找到该服务，需手动注册：

     alter system register;
     

  2. 登录本地CDB后执行show parameter local_listener，确认数据库的监听指向是否正确。

• 验证文件权限
  确保tnsnames.ora所在目录及文件对当前用户具备读权限：

  ls -l $ORACLE_HOME/network/admin/tnsnames.ora
  

  若权限不足，执行chmod 644 $ORACLE_HOME/network/admin/tnsnames.ora调整权限。

内容的提问来源于stack exchange，提问作者Mike