Linux下启动Kafka提示找不到kafka.Kafka主类错误的解决方法

错误产生原因 #

该错误本质是JVM启动Kafka进程时，无法在类路径下找到Kafka的主类文件，结合对应操作流程，触发原因通常为以下三类：

• 启动命令执行路径错误：kafka-server-start.sh默认通过相对路径加载当前目录下libs文件夹中的所有依赖jar包，如果你没有进入Kafka的根目录就执行脚本，脚本无法定位到核心依赖包kafka_2.13-3.1.0.jar，就会抛出主类找不到的错误。
• 安装包文件损坏：如果下载过程中网络中断、解压时出现磁盘IO错误，会导致libs目录下的核心jar包缺失、损坏，类加载自然失败。
• Java环境不符合要求：Kafka 3.1.0依赖Java 8及以上版本运行，如果系统默认Java版本过低，或者JAVA_HOME环境变量配置错误指向无效的JDK路径，也会触发类加载异常。

可行解决方案 #

按优先级逐一排查即可：

• 修正命令执行路径
  先切换到Kafka的根目录再执行启动命令，操作如下：

  # 进入放在HOME路径下的Kafka根目录，如果重命名过文件夹，替换成对应名称即可
  cd ~/kafka_2.13-3.1.0
  # 先启动内置的ZooKeeper，跳过这步即使类加载正常也会启动失败
  bin/zookeeper-server-start.sh -daemon config/zookeeper.properties
  # 再启动Kafka服务
  bin/kafka-server-start.sh config/server.properties
  

  如果需要全局调用Kafka命令，可以在系统环境变量中配置KAFKA_HOME为Kafka的根目录路径，并将$KAFKA_HOME/bin加入PATH，脚本会自动读取KAFKA_HOME路径加载依赖，不再要求必须在根目录执行命令。
• 校验安装包完整性
  进入Kafka根目录下的libs文件夹，检查是否存在kafka_2.13-3.1.0.jar文件，正常该文件大小约10MB。如果文件不存在或大小异常，删除当前解压目录，重新解压安装包；如果解压后仍缺失文件，重新下载二进制安装包即可。
• 校验Java运行环境
  执行java -version确认输出的Java版本为1.8及以上，再执行echo $JAVA_HOME确认环境变量指向有效的JDK安装路径。如果版本不符合要求，升级JDK版本即可；如果JAVA_HOME未配置，在用户目录下的.bashrc文件中添加对应配置后生效即可。

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