WSL2中运行Confluent时ZooKeeper启动失败：无法打开zookeeper-gc.log

问题背景 #

在WSL2环境下使用Zookeeper 3.5.8、Confluent 6.1.0和OpenJDK 17.0.12搭建Kafka应用时，执行confluent local services start报错Error: ZooKeeper failed to start。单独运行zookeeper-server-start命令时，出现以下错误日志：

[0.006s][error][logging] Error opening log file '/mnt/c/Windows/system32/confluent-6.1.0/bin/../logs/zookeeper-gc.log': No such file or directory
[0.006s][logging] Initialization of output 'file=/mnt/c/Windows/system32/confluent-6.1.0/bin/../logs/zookeeper-gc.log:time,tags:filecount=10,filesize=100M' failed.
Invalid -Xlog option '-Xlog:gc*:file=/mnt/c/Windows/system32/confluent-6.1.0/bin/../logs/zookeeper-gc.log:time,tags:filecount=10,filesize=100M', see error log for details.
Error: Could not create the Java Virtual Machine.
Error: A fatal exception has occurred. Program will exit.

核心原因 #

1. 路径权限与位置错误：Confluent被解压到Windows系统目录C:\Windows\System32下，WSL2对该目录的访问存在严格权限限制，无法创建日志文件；同时WSL解析Windows路径时的异常，导致相对路径../logs无法正确指向Confluent的日志目录。
2. Java版本兼容性冲突：Confluent 6.1.0官方适配Java 8/11，而你使用的OpenJDK 17对GC日志的-Xlog参数格式做了调整，旧版参数在Java 17下会失效，直接导致JVM启动失败。

解决步骤 #

步骤1：迁移Confluent到WSL本地目录 #

将Confluent从Windows系统目录迁移到WSL2的本地用户目录，避免权限问题：

# 复制Confluent到WSL本地目录（示例路径）
cp -r /mnt/c/Windows/system32/confluent-6.1.0 ~/
# 进入迁移后的目录
cd ~/confluent-6.1.0

步骤2：切换兼容的Java版本（推荐方案） #

由于Confluent 6.1.0对Java 17适配不佳，建议切换到官方推荐的Java 11：

# Ubuntu/Debian系统安装OpenJDK 11
sudo apt update && sudo apt install openjdk-11-jdk
# 设置环境变量
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH

步骤3：修改GC日志参数（坚持使用Java 17时） #

若必须使用Java 17，需修改Zookeeper启动脚本中的GC日志参数：

1. 打开启动脚本：

vim bin/zookeeper-server-start

2. 找到包含-Xlog:gc*的行，替换为Java 17兼容的格式：
   原参数示例：

   -Xlog:gc*:file=$LOG_DIR/zookeeper-gc.log:time,tags:filecount=10,filesize=100M
   

   替换为：

   -Xlog:gc*,gc+age=trace,safepoint:file=$LOG_DIR/zookeeper-gc.log:time,tags:filecount=10,filesize=100M
   

3. 保存退出后重新启动：

bin/zookeeper-server-start etc/kafka/zookeeper.properties

步骤4：验证启动 #

完成上述操作后，执行命令验证服务启动：

confluent local services start

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