macOS Big Sur下Oracle SQL Developer提示Java版本错误无法启动怎么办

核心原因 #

即使通过Homebrew安装了Java 11，仍出现报错的常见诱因如下：

• Oracle SQL Developer默认仅扫描/Library/Java/JavaVirtualMachines/路径下的系统级JDK安装包，而Homebrew安装的OpenJDK默认存放在brew自身的Cellar目录，不会自动关联到系统JDK路径
• SQL Developer本地配置文件中指定的Java_home路径与实际安装的Java 11路径不匹配
• 部分Homebrew安装包仅安装了JRE而非完整JDK，不符合SQL Developer的运行要求

报错截图如下：

解决步骤 #

1. 首先确认已安装完整Java 11 JDK，终端执行以下命令均返回正常版本信息即为符合要求：

java -version
javac -version

2. 将Homebrew安装的OpenJDK 11软链到系统JDK扫描路径

• Intel芯片Mac执行命令：
  sudo ln -sfn /usr/local/opt/openjdk@11/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-11.jdk
• ARM（M系列）芯片Mac执行命令：
  sudo ln -sfn /opt/homebrew/opt/openjdk@11/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-11.jdk

3. 修改SQL Developer的Java路径配置
   打开/Applications/SQLDeveloper.app/Contents/Resources/sqldeveloper/sqldeveloper/bin/sqldeveloper.conf文件，添加或修改对应配置项：
   SetJavaHome /Library/Java/JavaVirtualMachines/openjdk-11.jdk/Contents/Home
4. 若仍无法启动，可在终端执行命令手动指定JDK路径启动：
   /Applications/SQLDeveloper.app/Contents/MacOS/sqldeveloper --jdkhome /Library/Java/JavaVirtualMachines/openjdk-11.jdk/Contents/Home

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