Debian 上使用 SQL*Plus 的常见错误与解决
一 连接类错误
| 报错或现象 |
可能原因 |
快速排查与解决 |
| ORA-12170: TNS:connect timeout occurred |
目标主机不可达、监听未启动、端口被防火墙拦截 |
在服务器执行：lsnrctl status 检查监听；必要时 lsnrctl start；确认服务器防火墙放行 TCP 1521；从客户端测试网络连通性（如 telnet host 1521） |
| ORA-12541: TNS:no listener |
监听未运行或配置错误 |
启动监听：lsnrctl start；核对 listener.ora 中 HOST/PORT 与实际一致；变更主机名/IP 后需同步配置并重启监听 |
| ORA-12560: TNS:protocol adapter error |
客户端缺少/未正确配置 Oracle 客户端、环境变量异常 |
安装 Oracle Instant Client；正确设置 PATH、必要时设置 ORACLE_HOME、TNS_ADMIN；确保 tnsnames.ora 路径与内容正确 |
| ORA-01017: invalid username/password; logon denied |
用户名或密码错误、账户被锁定/过期 |
确认凭据；必要时以 sysdba 登录后重置密码：alter user username identified by new_password;`；检查账户状态与 profile 限制 |
| 使用 @tns_alias 解析失败 |
TNSNAMES.ORA 路径或条目错误 |
检查 $ORACLE_HOME/network/admin/tnsnames.ora 是否存在且条目正确；或改用 EZConnect：sqlplus user/pass@host:1521/service |
- 远程直连示例与监听检查命令：
- 直连：sqlplus scott/tiger@myhost.example.com:1521/orcl
- 监听状态：lsnrctl status；启动监听：lsnrctl start
- 上述步骤可快速定位网络、监听与认证问题。
二 登录与环境类错误
- SP2-0667: Message file sp2.msb not found
- 现象：进入 sqlplus / as sysdba 报 SP2-0667，找不到消息文件。
- 处理：检查 $ORACLE_HOME/sqlplus/mesg 目录及 sp2.msb* 文件是否存在且可读；确认当前用户对 $ORACLE_HOME 及子目录有访问权限；必要时修正权限或以具备权限的账户启动。
三 编辑与显示类问题
- 方向键出现 ^[[A^[[B 等乱码、无法使用历史
- 解决：安装 rlwrap 并封装调用：sudo apt-get install rlwrap；使用 rlwrap sqlplus；或在 ~/.bashrc 添加别名：alias sqlplus=‘rlwrap sqlplus’，之后直接输入 sqlplus 即可具备方向键与历史功能。
- Backspace 退格显示乱码
- 解决：在终端设置终端 erase 字符为 ^?（bash）：执行 stty erase ^?；或写入 ~/.bash_profile 持久化。如使用 csh/tcsh，可用 stty erase ^H 并写入 ~/.cshrc。
四 执行脚本与权限类错误
- SP2-0042: 未知命令“xx” - 其余行忽略
- 常见原因：在 SQLPlus 中误执行了非 SQLPlus 内建命令、命令拼写错误、或 / … / 注释未正确闭合导致后续被当作命令解析。
- 处理：核对命令拼写与语法；避免在 SQL*Plus 里直接运行操作系统命令；检查脚本注释是否成对闭合；必要时在脚本前后使用 SET SQLBLANKLINES ON 并注意空行处理。
- ORA-04089: 无法对 SYS 拥有的对象创建触发器
- 原因：以 SYS 身份尝试创建对象（如触发器）被禁止。
- 处理：改用普通用户（如 SCOTT）创建对象；SYS 仅用于管理操作，业务对象应放在普通用户方案中。
