为何Mac升级Java11后Spinnaker Hal启动失败，报类版本不兼容错误？

日志核心报错指向版本不匹配：Halyard 守护进程启动时实际加载的运行环境仍是 Java 8，并未使用终端全局配置的 Java 11

• 日志明确提示：com/netflix/spinnaker/halyard/Main 的 class 文件版本为 55.0（对应 Java 11 编译），但当前运行的 Java 运行时仅支持最高 52.0 版本（对应 Java 8）
• 终端执行java -version显示的 Java 11 是当前 shell 的全局配置，而 Halyard 的启动脚本存在硬编码路径、或未继承 shell 环境变量的问题，导致服务启动时仍调用系统默认的旧版 Java 8，因此单独升级全局 Java 版本无法解决该报错。

• 清理残留进程
  执行pkill -f halyard杀掉所有残留的、启动失败的 Halyard 进程，避免旧进程干扰后续启动。
• 确认 Java 11 实际路径
  执行命令/usr/libexec/java_home -v 11，获取本地 Java 11 的安装路径，返回结果通常为/Library/Java/JavaVirtualMachines/openjdk-11.0.10.jdk/Contents/Home。
• 修正 Halyard 的 Java 引用
  1. 检查 Halyard 启动脚本的 Java 配置：执行cat /usr/local/bin/hal | grep -i java，查看脚本是否硬编码了旧 Java 8 的路径，如果存在硬编码路径，将其替换为上一步获取的 Java 11 路径。
  2. 配置全局环境变量：将export JAVA_HOME=$(/usr/libexec/java_home -v 11)写入当前使用的 shell 配置文件（zsh 对应~/.zshrc，bash 对应~/.bash_profile），执行source 对应配置文件路径让配置生效。
  3. 检查系统服务配置：如果 Halyard 是通过系统 LaunchDaemon 启动的，检查/Library/LaunchDaemons/下 spinnaker 相关的 plist 配置文件，删除文件中硬编码的旧 Java 路径，让服务继承系统配置的 JAVA_HOME 路径。
• 启动验证
  执行hal daemon start手动启动守护进程，等待 10-20 秒后执行hal -v，查看启动超时问题是否解决；同时查看/var/log/spinnaker/halyard/下的最新日志，确认无UnsupportedClassVersionError报错即为修复成功。

常见坑点：Mac 系统自带的/usr/bin/java默认指向旧版 Java 8，即使自行安装了 Java 11 并配置了全局 shell 环境，未显式指定 Java 路径的启动脚本仍会调用这个系统默认的旧 Java 运行时，导致版本不匹配报错。

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