SQL Developer 24.3.1连接Oracle 21c用户时Schema Browser无法加载

问题描述 #

已安装SQL Developer 24.3.1版本，解压至Oracle 21c（21.3.0.0）数据库安装目录的product文件夹中，执行sqldeveloper.exe连接SYSTEM用户时出现以下异常：

• Schema Browser无法加载，查询完全无法运行
• 打开Preferences Window时应用程序卡顿

根本原因排查与解决方案 #

1. 目录权限/路径冲突 #

• 原因：Oracle数据库安装目录通常带有严格权限限制，SQL Developer解压在此目录下可能无法正常读写配置文件；同时目录路径过长或与Oracle自带组件产生冲突，也会导致功能异常。
• 解决：
  • 将SQL Developer完整迁移到独立的普通目录（如C:\sqldeveloper-24.3.1），避免与Oracle安装目录重叠
  • 右键点击sqldeveloper.exe，选择以管理员身份运行，验证是否恢复正常

2. JDK版本不兼容 #

• 原因：SQL Developer 24.3.1官方推荐使用JDK 11或17，Oracle 21c自带的JDK版本可能不符合要求，导致程序运行时出现兼容性问题。
• 解决：
  • 下载并安装OpenJDK 11或17（推荐17）
  • 打开SQL Developer安装目录下的sqldeveloper.conf文件，添加以下配置指定JDK路径（替换为你的实际JDK路径）：

    SetJavaHome C:\Program Files\OpenJDK\jdk-17.0.11
    

  • 保存文件后重启SQL Developer

3. 用户配置文件损坏 #

• 原因：SQL Developer的用户配置目录（C:\Users\<你的用户名>\AppData\Roaming\SQL Developer）中的文件损坏，导致Schema Browser、Preferences等功能无法正常加载。
• 解决：
  • 关闭SQL Developer
  • 找到上述配置目录，将SQL Developer文件夹重命名为SQL Developer_backup
  • 重新启动SQL Developer，程序会自动生成全新的配置文件，测试功能是否恢复

4. 数据库连接/服务异常 #

• 原因：Oracle数据库服务未正常启动，或连接配置错误，导致SQL Developer无法正常获取Schema信息。
• 解决：
  • 打开Windows服务管理器，检查OracleServiceORCL（你的数据库实例名）和OracleOraDB21Home1TNSListener服务是否处于运行状态，未启动则手动启动
  • 删除现有SYSTEM用户连接，重新创建：选择Oracle - JDBC Thin驱动，输入正确的主机名、端口、服务名（或SID），测试连接成功后再尝试操作Schema Browser

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