Windows10下Apache Kafka3.9.0启动失败，遇命令行过长等报错

问题重现 #

在Windows 10系统中安装Kafka 3.9.0到C:\kafka，配置好JAVA_HOME和KAFKA_HOME系统变量，修改zookeeper.properties和server.properties的临时路径后，执行启动命令：

C:\kafka> .\bin\windows\zookeeper-server-start.bat .\config\zookeeper.properties

出现错误：

A linha de entrada é muito longa.
A sintaxe do comando está incorreta.

翻译为：命令行过长。命令语法不正确。

尝试过重装Kafka、删除多余Java系统路径、使用完整路径执行命令均无效；直接运行jar包：

java -cp "libs\*" org.apache.zookeeper.server.quorum.QuorumPeerMain config\zookeeper.properties

出现log4j警告后进程挂起：

log4j:WARN No appenders could be found for logger (org.apache.zookeeper.server.quorum.QuorumPeerConfig).
log4j:WARN Please initialize the log4j system properly.
log4j:WARN See http://logging.apache.org/log4j/1.2/faq.html#noconfig for more info.

解决方案 #

方法1：修改bat文件解决命令行过长问题 #

Windows系统对命令行长度有上限，Kafka默认bat文件会直接拼接所有jar包路径到classpath，jar包数量过多时会触发该错误。修改C:\kafka\bin\windows\zookeeper-server-start.bat文件：

1. 打开文件，替换原有构建classpath的代码段为：

@echo off
setlocal enabledelayedexpansion

set BASE_DIR=%~dp0..\..
set LIB_DIR=%BASE_DIR%\libs

set CLASSPATH=
for %%i in ("%LIB_DIR%\*.jar") do (
    set CLASSPATH=!CLASSPATH!;%%i
)
set CLASSPATH=%CLASSPATH%;%BASE_DIR%\config

call "%JAVA_HOME%\bin\java" %KAFKA_HEAP_OPTS% %KAFKA_JVM_PERFORMANCE_OPTS% %KAFKA_DEBUG_OPTS% %KAFKA_JMX_OPTS% %KAFKA_LOG4J_OPTS% -cp "%CLASSPATH%" org.apache.zookeeper.server.quorum.QuorumPeerMain "%~1"
endlocal

2. 保存文件后，重新执行启动命令：

.\bin\windows\zookeeper-server-start.bat .\config\zookeeper.properties

方法2：直接运行jar包并指定log4j配置 #

若不想修改bat文件，直接运行jar包时需指定log4j配置文件，确保日志系统正常初始化：

java -Dlog4j.configuration=file:C:\kafka\config\log4j.properties -cp "C:\kafka\libs\*" org.apache.zookeeper.server.quorum.QuorumPeerMain C:\kafka\config\zookeeper.properties

执行后ZooKeeper将正常启动，不会再出现log4j警告和进程挂起问题。

额外注意事项 #

• 确保JAVA_HOME指向JDK 8或11（Kafka 3.9.0推荐的Java版本），避免高版本Java引发兼容性问题。
• 检查zookeeper.properties中dataDir路径是否正确，路径不要包含空格或特殊字符。

内容的提问来源于stack exchange，提问作者Davi Rafael Franke