SQL*Plus 在 Debian 上常见报错与修复步骤
一、先快速定位问题
- 确认命令是否存在与可用：运行 which sqlplus 或 sqlplus -v；若提示“未找到命令”，多为未安装或 PATH 未配置。若命令存在但执行报错，记录完整报错文本（如缺少库、权限、连接拒绝等）。
- 检查库依赖：运行 ldd $(which sqlplus)，查看是否有 not found 的共享库（常见为 libaio.so.1、libsqlplus.so 等）。
- 网络连通与监听：对目标库执行 tnsping 服务名 或 nc -vz 主机 1521，确认端口可达；必要时让 DBA 检查 listener 状态。
- 区分客户端与服务端问题：仅安装 Instant Client 的机器没有数据库实例，出现 ORA-01034/ORA-27101 属于正常（因为没有实例可启动），应改为连接远程数据库而非本地 startup。
二、安装与依赖修复（Instant Client 方案）
- 安装依赖与工具：sudo apt-get update && sudo apt-get install -y alien libaio1
- 下载 Oracle Instant Client RPM（至少包含 Basic、SQL*Plus，如需编译再加 SDK/Devel），选择合适版本（如 12.1 或 19 等）。
- 转换为 DEB 并安装（示例）：
sudo alien -i oracle-instantclient12.1-basic-.x86_64.rpm
sudo alien -i oracle-instantclient12.1-sqlplus-.x86_64.rpm
sudo alien -i oracle-instantclient12.1-devel-*.x86_64.rpm
- 配置库路径：
echo “/usr/lib/oracle/12.1/client64/lib/” | sudo tee /etc/ld.so.conf.d/oracle.conf
sudo ldconfig
- 设置环境变量（写入 ~/.bashrc 或 ~/.profile）：
export ORACLE_HOME=/usr/lib/oracle/12.1/client64
export PATH=$ORACLE_HOME/bin:$PATH
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH
. ~/.bashrc
- 验证：sqlplus -v 应显示版本号。
三、常见报错对照与修复
-
“sqlplus: command not found” 或 “不是内部命令”
原因：未安装或 PATH 未包含 $ORACLE_HOME/bin。
处理：确认安装成功，执行 echo $PATH 是否包含 /usr/lib/oracle//client/bin；必要时重新登录或 source 配置文件。
-
“error while loading shared libraries: libaio.so.1: cannot open shared object file”
原因：缺少 libaio。
处理：sudo apt-get install -y libaio1。
-
“error while loading shared libraries: libsqlplus.so: cannot open shared object file”
原因：动态库路径未纳入系统缓存。
处理：确认库目录（如 /usr/lib/oracle/12.1/client64/lib/）已写入 /etc/ld.so.conf.d/oracle.conf 并执行 sudo ldconfig。
-
“ORA-01034: ORACLE not available / ORA-27101: shared memory realm does not exist”
原因：本机没有数据库实例（常见于仅装了 Instant Client）。
处理：不要在本机执行 startup；改用远程连接串：sqlplus user/pass@//host:1521/service 或配置 tnsnames.ora 后使用别名连接。
-
“TNS:listener does not currently know of SID given in connect descriptor（ORA-12505）”
原因：SID/Service 与数据库不一致或监听未注册。
处理：核对 tnsnames.ora 与数据库实际 SID/SERVICE_NAME，并请 DBA 确认监听已启动且注册了该服务。
-
方向键乱码（显示 ^[[A 等）
原因：sqlplus 默认不处理 readline。
处理：安装 rlwrap 并使用 rlwrap sqlplus；或设置合适的 TERM 变量以改善终端行为。
四、连接方式与网络排查要点
- 直连写法：sqlplus user/password@//host:1521/service 或 sqlplus user/password@host:1521/SID（根据数据库配置选择 SERVICE 或 SID）。
- 使用 TNS 别名：在 $ORACLE_HOME/network/admin/tnsnames.ora 中配置别名后，可用 sqlplus user/pass@别名。
- 网络检查：
- tnsping 别名（或 host:1521/service）验证解析与监听可达；
- nc -vz host 1521 验证端口连通；
- 若使用 Easy Connect，确保 SERVICE_NAME 正确且监听已注册该服务。
五、仍未解决时的高效求助信息
- 提供以下关键信息：
- Debian 版本（cat /etc/debian_version）、CPU 架构（uname -m）
- sqlplus -v 输出、安装方式（Instant Client 版本与安装步骤）
- 完整报错文本、执行命令与连接串
- ldd $(which sqlplus) 结果、/etc/ld.so.conf.d/oracle.conf 内容
- tnsping 与 nc -vz 结果、相关 tnsnames.ora/sqlnet.ora 片段（脱敏）
