SQLcl无法使用TNS凭证连接，报错no ocijdbc21 in java.library.path

问题原因 #

1. 连接串解析逻辑差异：SQLcl对直接输入的TNS连接串格式要求与SQLPlus不同，SQLPlus支持的带引号长连接串，在SQLcl中会因解析规则严格导致报错。
2. 快捷键依赖终端配置：SQLcl基于Java实现终端交互，默认情况下部分系统的Ctrl+C/V快捷键需要终端层面开启支持，而非工具本身直接支持。

解决方案 #

方式1：调整直接连接串格式 #

无需给整个连接串加引号，直接使用以下格式连接：

{User}/{Password}@(DESCRIPTION=(ADDRESS=(PROTOCOL={Protocol})(HOST={Host})(PORT={Port}))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME={Service})))

如果密码包含特殊字符，仅给密码部分加双引号即可：

{User}/"{Password}"@(DESCRIPTION=(ADDRESS=(PROTOCOL={Protocol})(HOST={Host})(PORT={Port}))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME={Service})))

方式2：配置TNS Names文件 #

1. 定位/创建tnsnames.ora文件

   • Windows：路径通常为%ORACLE_HOME%\network\admin\tnsnames.ora
   • Linux/macOS：路径通常为$ORACLE_HOME/network/admin/tnsnames.ora
     若文件不存在，手动创建即可。

2. 添加TNS条目
   在文件中写入如下格式的配置（替换占位符为实际信息）：

   MY_DB =
     (DESCRIPTION =
       (ADDRESS = (PROTOCOL = {Protocol})(HOST = {Host})(PORT = {Port}))
       (CONNECT_DATA =
         (SERVER = DEDICATED)
         (SERVICE_NAME = {Service})
       )
     )
   

3. 让SQLcl识别TNS配置

   • 配置环境变量TNS_ADMIN，指向tnsnames.ora所在目录；
   • 或启动SQLcl时指定参数：sql -tns /path/to/tns/admin

4. 使用TNS别名连接
   直接用别名替代长连接串：

   {User}/{Password}@MY_DB
   

快捷键问题处理 #

• Windows系统：右键点击SQLcl窗口标题栏→选择「属性」，勾选「快速编辑模式」，即可使用Ctrl+V粘贴、Ctrl+C终止当前命令。
• Linux/macOS系统：使用终端默认粘贴快捷键（如Cmd+V或Shift+Insert），Ctrl+C默认可终止命令，若无效检查终端自身配置。

内容的提问来源于stack exchange，提问作者Felipe Vidal