Ubuntu 22.04安装Oracle SQL Developer遇模块未找到错误求助

问题背景 #

• 系统：Ubuntu 22.04 (jammy)
• 操作过程：
  1. 安装Oracle SQL Developer后初始运行正常，可创建数据库连接
  2. 禁用了Oracle Data Miner、Oracle OLAP等10项功能（保留subversion和git，因DataModel依赖）
  3. 软件突然无法启动，出现大量模块未找到错误，典型报错：

     Warning - could not install some modules: oracle.external.xsql - org.netbeans.InvalidException: Netigso: /home/shashwat/Downloads/Programs/Oracle_SQL_Developer/sqldeveloper/external/oracle.external.xsql.jar: Not found bundle:oracle.external.xsql...
     

  4. 尝试卸载JDK、删除安装包重新安装，问题依旧

解决方案 #

方法1：恢复禁用的模块配置 #

SQL Developer的模块禁用配置存储在用户目录的配置文件中，重装软件不会覆盖该文件，这是问题根源：

1. 打开终端，进入用户配置目录：

   cd ~/.sqldeveloper
   

   执行ls查看具体版本号文件夹，进入对应目录找到product.conf文件
2. 编辑product.conf，找到以AddVMOption -Dorg.netbeans.modules.disable开头的行，这些是你禁用的模块列表
3. 删除这些行，或移除导致依赖缺失的模块条目，保存文件
4. 重新启动SQL Developer

方法2：完全重置用户配置 #

如果方法1无效，直接清空用户配置目录，让软件生成默认配置：

1. 关闭SQL Developer，若有残留进程执行：

   killall sqldeveloper
   

2. 备份配置目录（可选）：

   mv ~/.sqldeveloper ~/.sqldeveloper_backup
   

3. 重新启动SQL Developer，软件会自动创建新的默认配置

方法3：排查模块依赖（按需恢复） #

若不想恢复所有禁用模块，可逐个排查依赖关系：

1. 启动软件时记录完整报错信息，整理所有缺失的模块名称
2. 对照你禁用的模块列表，找出哪些模块是缺失模块的依赖项
3. 在product.conf中移除对应依赖模块的禁用配置，保存后重启

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