Debian 上 SQL*Plus 常见报错与处理步骤
一、先快速定位问题
- 确认命令是否存在与路径：运行 which sqlplus；若未找到，说明 Oracle Instant Client/SQL*Plus 未安装或 PATH 未包含安装目录。
- 查看库依赖是否缺失：运行 ldd $(which sqlplus)，检查是否有 not found 的共享库。
- 直接执行看报错原文：例如 sqlplus64 user/pass@//host:1521/SID，根据提示修复。
- 若是在脚本或定时任务中执行，优先使用 sqlplus 的绝对路径，避免 PATH 不一致导致“未找到命令”。
二、安装与依赖修复（首次安装或环境损坏时）
- 安装依赖库：
- Debian 系常见缺 libaio1：执行 sudo apt-get install libaio1。
- 安装 Instant Client（Debian 官方无原生包，常用 RPM 转 DEB 的方式）：
- 安装转换工具：sudo apt-get install alien。
- 下载 Oracle Instant Client 的 Basic、SQL*Plus（必要时可加 SDK/Devel）RPM 包。
- 转换为 DEB 并安装（顺序建议先 Basic，再 SQL*Plus，最后 SDK/Devel）：
- sudo alien -i oracle-instantclient-basic-*.rpm
- sudo alien -i oracle-instantclient-sqlplus-*.rpm
- （可选）sudo alien -i oracle-instantclient-devel-*.rpm
- 说明：这是社区常用做法，虽非 Oracle 官方支持，但在 Debian/Ubuntu 上广泛使用。
三、库路径与运行环境配置
- 配置动态库路径：
- 查找库目录（示例：/usr/lib/oracle//client64/lib/）。
- 新建配置文件：sudo nano /etc/ld.so.conf.d/oracle.conf，写入该路径。
- 更新缓存：sudo ldconfig。
- 设置环境变量（写入 ~/.bashrc 或 /etc/profile 并 source 使其生效）：
- 示例（按实际版本与路径调整）：
- export ORACLE_HOME=/usr/lib/oracle/12.1/client64
- export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH
- export PATH=$ORACLE_HOME/bin:$PATH
- 验证：再次运行 sqlplus64 -v 或连接串测试。上述库路径配置与环境变量设置能解决多数“找不到共享库/命令不可用”的问题。
四、常见报错对照与修复
- 报错：sqlplus: command not found
- 处理：确认已安装；用 which sqlplus 定位；将 $ORACLE_HOME/bin 加入 PATH；在脚本/定时任务中使用 绝对路径。
- 报错：error while loading shared libraries: libaio.so.1: cannot open shared object file
- 处理：安装 libaio1（sudo apt-get install libaio1）。
- 报错：sqlplus64: error while loading shared libraries: libsqlplus.so: cannot open shared object file
- 处理：按“第三部分”将 Instant Client lib 目录加入 /etc/ld.so.conf.d/oracle.conf 并运行 sudo ldconfig。
- 报错：SP2-0734: unknown command beginning “crea…”
- 处理：SQL*Plus 默认不允许一条 SQL 语句中出现空行。可在脚本最前加入 SET SQLBLANKLINES ON;，或删除语句内部空行。
- 报错：方向键乱码、无历史（如 ^[[A）
- 处理：安装 rlwrap：sudo apt-get install rlwrap；使用 rlwrap sqlplus；或在 ~/.bashrc 中设置别名：alias sqlplus=‘rlwrap sqlplus’。
- 定时任务执行失败
- 处理：在 crontab 中使用 sqlplus 的绝对路径，并确保环境变量正确（必要时在 crontab 中显式导出）。