启动Kafka与ZooKeeper时出现「无法找到Java运行时」的问题

问题场景 #

在MacOS本地部署Kafka和ZooKeeper，执行官方快速启动命令时：

sudo bin/zookeeper-server-start.sh config/zookeeper.properties

出现错误提示：

The operation couldn’t be completed. Unable to locate a Java Runtime.
Please visit http://www.java.com for information on installing Java.

但本地已正常安装OpenJDK 19.0.2，验证信息如下：

(base) sourav.kumar@PFIN-BLR-1RC9W kafka_2.13-3.4.0 % which java
/usr/bin/java
(base) sourav.kumar@PFIN-BLR-1RC9W kafka_2.13-3.4.0 % which javac
/usr/bin/javac
(base) sourav.kumar@PFIN-BLR-1RC9W kafka_2.13-3.4.0 % java -version
openjdk version "19.0.2" 2023-01-17
OpenJDK Runtime Environment (build 19.0.2+7-44)
OpenJDK 64-Bit Server VM (build 19.0.2+7-44, mixed mode, sharing)
(base) sourav.kumar@PFIN-BLR-1RC9W kafka_2.13-3.4.0 % /usr/bin/java -version
openjdk version "19.0.2" 2023-01-17
OpenJDK Runtime Environment (build 19.0.2+7-44)
OpenJDK 64-Bit Server VM (build 19.0.2+7-44, mixed mode, sharing)
(base) sourav.kumar@PFIN-BLR-1RC9W kafka_2.13-3.4.0 % javac -version
javac 19.0.2

问题原因 #

sudo执行命令时会重置系统环境变量，导致当前用户的JAVA_HOME配置或Java路径未被加载，因此启动脚本无法找到Java运行时。

解决方案 #

方法1：启动时显式指定Java路径 #

在sudo命令中直接传入JAVA_HOME环境变量，利用系统自带的工具获取默认Java路径：

sudo JAVA_HOME=$(/usr/libexec/java_home) bin/zookeeper-server-start.sh config/zookeeper.properties

方法2：配置sudo保留环境变量 #

修改sudoers配置，让sudo保留Java相关环境变量，避免每次手动指定：

1. 打开sudoers编辑界面：

sudo visudo

2. 找到Defaults env_reset行，添加env_keep配置：

Defaults env_reset
Defaults env_keep += "JAVA_HOME PATH"

3. 按Ctrl+O保存，Ctrl+X退出，之后再执行sudo启动命令即可正常识别Java。

方法3：避免使用sudo启动（推荐） #

Kafka和ZooKeeper默认不需要sudo权限，先检查当前用户对Kafka目录的权限：

ls -ld kafka_2.13-3.4.0

如果权限不足，修改目录归属：

chown -R $(whoami) kafka_2.13-3.4.0

之后直接执行启动命令，无需sudo：

bin/zookeeper-server-start.sh config/zookeeper.properties

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