1. lsnrctl命令未找到
原因：lsnrctl未安装或未添加到系统PATH环境变量中。
解决方法：① 确认Oracle客户端是否安装（可通过which lsnrctl查找路径）；② 若未安装，使用sudo apt-get update && sudo apt-get install oracle-instantclient-basic安装；③ 将lsnrctl路径添加到PATH中（如export PATH=$PATH:/path/to/oracle/bin），并写入~/.bashrc或~/.profile使配置生效。
2. 权限不足
原因：当前用户无执行lsnrctl或管理监听器的权限。
解决方法：① 使用sudo提升权限（如sudo lsnrctl start）；② 切换到oracle用户（su - oracle）；③ 将当前用户加入oracle组（sudo usermod -a -G oracle <username>），并重新登录使组权限生效。
3. 监听器未启动或状态异常
原因：监听器进程未启动、配置错误或依赖的数据库实例未启动。
解决方法：① 检查监听器状态（lsnrctl status），若未启动则执行lsnrctl start；② 若启动失败，查看$ORACLE_HOME/network/log/listener.log日志定位具体错误；③ 确保数据库实例已启动（sqlplus / as sysdba，执行SELECT status FROM v$instance;）。
4. 配置文件错误（listener.ora/tnsnames.ora）
原因：listener.ora（监听器配置）或tnsnames.ora（客户端连接配置）中存在语法错误、路径错误或参数配置不当。
解决方法：① 检查配置文件格式（如括号匹配、参数完整性），默认路径为$ORACLE_HOME/network/admin/；② 确认HOST（主机名/IP）、PORT（端口，默认1521）、SID（数据库实例名）等参数正确；③ 修改后重启监听器（lsnrctl stop && lsnrctl start）。
5. 网络连接或端口问题
原因：客户端与监听器之间网络不通、防火墙阻止端口通信或端口冲突。
解决方法：① 使用ping <监听器IP>测试网络连通性；② 检查端口占用（netstat -tuln | grep 1521或ss -tuln | grep 1521），若有冲突则修改端口；③ 开放防火墙端口（sudo ufw allow 1521或sudo firewall-cmd --add-port=1521/tcp --permanent && sudo firewall-cmd --reload）。
6. 环境变量未正确设置
原因：ORACLE_HOME（Oracle安装目录）、PATH（包含lsnrctl路径）、ORACLE_SID（数据库实例名）等环境变量未设置或设置错误。
解决方法：① 确认变量值正确（如echo $ORACLE_HOME应指向Oracle安装目录）；② 在~/.bashrc或~/.profile中添加配置（如export ORACLE_HOME=/u01/app/oracle/product/19.0.0/dbhome_1、export PATH=$ORACLE_HOME/bin:$PATH、export ORACLE_SID=your_sid）；③ 执行source ~/.bashrc使配置生效。
7. 特定错误场景：TNS-12541（No listener）
原因：监听器未启动或监听器名称配置错误。
解决方法：① 执行lsnrctl start启动监听器；② 检查listener.ora中的LISTENER名称是否与lsnrctl命令默认使用的名称一致（通常为LISTENER）。
8. 特定错误场景：TNS-12560（Protocol adapter error）
原因：协议适配器配置错误（如TCP/IP协议未启用）或版本不兼容。
解决方法：① 检查listener.ora中的PROTOCOL参数（应为TCP）；② 确保客户端与服务器端Oracle版本兼容。