如何解决SQLcl中出现的连接失败问题

错误核心是SQLcl 26.1尝试加载的OCI驱动版本（ocijdbc23）与Oracle 21c XE提供的OCI驱动版本（ocijdbc21）不兼容。SQLcl版本需与Oracle客户端驱动版本匹配，高版本SQLcl默认会查找对应高版本的OCI库，而21c数据库自带的是21版本的驱动。

方法1：使用JDBC Thin连接（绕过OCI依赖） #

直接指定Thin模式连接，无需依赖本地OCI驱动：

# 直接在命令行连接
sql.exe system/你的密码@localhost:1521/XEPDB1

# 或启动SQLcl后再执行连接命令
SQL> connect system/你的密码@//localhost:1521/XEPDB1

注：XEPDB1是21c XE默认的可插拔数据库，若连接容器数据库CDB，可替换为ORCLCDB

方法2：安装匹配版本的Oracle Instant Client #

1. 下载与SQLcl 26.1兼容的Oracle Instant Client（23c版本，Basic或Basic Light包）
2. 解压到任意目录（例如C:\app\USER\instantclient_23_3）
3. 将该目录添加到系统环境变量PATH的最前端，确保系统优先加载23c的OCI驱动
4. 重启命令提示符后重新尝试连接

方法3：降级SQLcl至与21c兼容的版本 #

下载对应Oracle 21c的SQLcl版本（如21.x系列）替换当前版本，使其自动匹配21c自带的ocijdbc21驱动。

• 连接成功后执行以下命令确认数据库版本：

  SELECT * FROM v$version;
  

• 若使用Thin连接，可执行以下命令确认连接协议：

  SELECT sys_context('USERENV', 'NETWORK_PROTOCOL') FROM dual;
  

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