Ubuntu下lsnrctl连接问题排查指南

1. 检查lsnrctl命令是否可用

首先确认lsnrctl是否已正确安装并配置到系统PATH中。在终端运行which lsnrctl，若未找到命令，可能是Oracle软件未安装或路径未添加。需将Oracle安装目录下的bin文件夹路径（如/u01/app/oracle/product/19c/dbhome_1/bin）添加到PATH环境变量中：

export PATH=$PATH:/u01/app/oracle/product/19c/dbhome_1/bin

保存后执行source ~/.bashrc使配置生效。

2. 验证环境变量设置

lsnrctl依赖ORACLE_HOME（Oracle安装目录）和ORACLE_SID（数据库实例名）两个关键环境变量。运行以下命令检查：

echo $ORACLE_HOME  # 应输出Oracle安装路径，如/u01/app/oracle/product/19c/dbhome_1
echo $ORACLE_SID   # 应输出数据库实例名，如ORCLCDB

若未设置或设置错误，可通过以下命令临时设置（重启后失效）：

export ORACLE_HOME=/u01/app/oracle/product/19c/dbhome_1
export ORACLE_SID=ORCLCDB
export PATH=$PATH:$ORACLE_HOME/bin

或永久添加到~/.bashrc文件中，再执行source ~/.bashrc。

3. 检查监听器状态

使用lsnrctl status命令查看监听器是否运行及配置信息。若监听器未启动，会提示“Listener is not running”；若已启动，会显示监听的端口（默认1521）、注册的服务及实例等信息。
若监听器未启动，运行lsnrctl start启动它；若启动失败，继续查看日志排查。

4. 查看监听器日志定位错误

监听器日志文件（listener.log）记录了启动、连接及错误详情，路径通常为$ORACLE_HOME/network/log/listener.log。使用以下命令实时查看日志：

tail -f $ORACLE_HOME/network/log/listener.log

重点关注“ERROR”“ORA-”开头的行，如“ORA-12541: TNS:no listener”表示监听器未启动，“ORA-12514: TNS:listener does not currently know of the requested service”表示服务未注册。

5. 测试网络连通性与端口访问

5.1 测试网络连接

使用ping命令测试客户端与服务器之间的网络连通性（替换为监听器所在服务器IP）：

ping <
    监听器IP>
    

若无法ping通，需检查物理连接、网卡配置或路由问题。

5.2 测试端口连通性

使用tnsping命令测试客户端是否能连接到监听器（替换为实际服务名）：

tnsping <
    service_name>
    

若失败，可能是端口被防火墙阻止或监听器未监听正确端口。
使用netstat或ss命令检查端口监听状态：

sudo netstat -tulnp | grep 1521  # 默认端口1521
# 或
sudo ss -tulnp | grep 1521

若无输出，说明监听器未监听该端口，需检查listener.ora配置。

6. 检查防火墙设置

Ubuntu防火墙（ufw或firewalld）可能阻止1521端口。若使用ufw，运行以下命令允许端口：

sudo ufw allow 1521/tcp
sudo ufw reload

若使用firewalld，运行：

sudo firewall-cmd --add-port=1521/tcp --permanent
sudo firewall-cmd --reload

确保防火墙规则生效后，再次测试端口连通性。

7. 验证监听器配置文件

监听器配置文件listener.ora（路径：$ORACLE_HOME/network/admin/listener.ora）的配置错误会导致连接失败。检查以下内容：

• 监听地址是否正确（如HOST = localhost或具体IP）；
• 端口号是否正确（默认1521）；
• 服务名是否与数据库实例匹配。
  示例配置：

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

SID_LIST_LISTENER =
  (SID_LIST =
    (SID_DESC =
      (SID_NAME = ORCLCDB)
      (ORACLE_HOME = /u01/app/oracle/product/19c/dbhome_1)
    )
  )

修改后需重启监听器使配置生效：lsnrctl stop & & lsnrctl start。

8. 检查权限问题

确保运行lsnrctl的用户对Oracle相关目录有读写权限，尤其是/tmp目录（Oracle临时文件存放路径）。运行以下命令检查并修改权限：

ls -ld /tmp          # 检查/tmp目录所有者（应为root）
sudo chown -R oracle:oinstall /tmp  # 修改/tmp目录所有者为oracle用户
sudo chmod -R 775 /tmp  # 设置/tmp目录权限

若使用非oracle用户运行，需切换到oracle用户：sudo -u oracle lsnrctl start。

9. 重启监听器与服务

完成上述排查后，重启监听器和数据库服务以应用更改：

lsnrctl stop  # 停止监听器
lsnrctl start # 启动监听器
sudo systemctl restart oracle-xe  # 重启Oracle数据库服务（适用于Xfce版）

再次运行lsnrctl status确认监听器状态，使用tnsping测试连接。

通过以上步骤逐一排查，可定位并解决大部分Ubuntu下lsnrctl连接问题。若问题仍未解决，建议查看Oracle官方文档或联系技术支持，提供日志文件中的具体错误信息以进一步分析。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！