Windows 11上从零搭建DolphinScheduler 3.1.3开发环境：保姆级避坑指南（含MySQL 8.0、Zookeeper 3.8.0配置）

最新推荐文章于 2026-08-10 16:57:42 发布

原创

最新推荐文章于 2026-08-10 16:57:42 发布 · 397 阅读

Windows 11上从零搭建DolphinScheduler 3.1.3开发环境：保姆级避坑指南

作为一名长期在Windows环境下进行分布式系统开发的工程师，我深知在Windows 11上搭建DolphinScheduler开发环境可能遇到的种种"坑"。本文将带你完整走一遍从环境准备到服务启动的全过程，特别针对Windows特有的权限问题、版本冲突和IDE配置等痛点提供解决方案。

1. 环境准备与基础组件安装

1.1 MySQL 8.0安装与配置

在Windows上安装MySQL需要注意几个关键点：

下载选择 ：从MySQL官网获取社区版安装包时，建议选择ZIP Archive版本而非Installer版本，这样可以避免安装过程中的各种兼容性问题。
配置文件优化 ：除了基础的my.ini配置外，还需要特别注意以下参数：

[mysqld]
# 解决DolphinScheduler可能遇到的时区问题
default-time-zone='+8:00'
# 提高连接稳定性
wait_timeout=28800
interactive_timeout=28800

安装过程中的常见问题 ：
- 如果遇到 Install/Remove of the Service Denied 错误，必须使用管理员权限运行CMD
- 初始化后生成的临时密码如果包含特殊字符，可能需要用双引号包裹
- 安装完成后，建议立即执行以下安全加固命令：

-- 修改root密码
ALTER USER 'root'@'localhost' IDENTIFIED BY '你的新密码';
-- 移除匿名用户
DELETE FROM mysql.user WHERE User='';
-- 禁止root远程登录
DELETE FROM mysql.user WHERE User='root' AND Host NOT IN ('localhost');
FLUSH PRIVILEGES;

1.2 Zookeeper 3.8.0安装要点

版本匹配是Zookeeper安装的关键。DolphinScheduler 3.1.3明确要求Zookeeper 3.8.x版本，使用其他版本会导致兼容性问题。

Windows特有配置 ：

修改zoo.cfg时，路径需要使用正斜杠或双反斜杠：

dataDir=D:/apache-zookeeper-3.8.0-bin/data
dataLogDir=D:/apache-zookeeper-3.8.0-bin/logs

启动时如果遇到JAVA_HOME问题，可以编辑zkServer.cmd，在开头添加：

set JAVA_HOME=C:\Program Files\Java\jdk1.8.0_331

验证安装 时，除了连接本地客户端，还应该检查四字命令：

echo stat | nc localhost 2181

1.3 开发工具链安装

前端开发环境 ：

Node.js建议使用16.13.x LTS版本，避免最新版可能存在的兼容性问题
Pnpm安装后需要设置镜像源加速：

pnpm config set registry https://registry.npmmirror.com

Java开发环境 ：

JDK推荐使用1.8或11，与DolphinScheduler官方推荐版本一致
Maven settings.xml需要配置阿里云镜像：

<mirror>
  <id>aliyunm

标签

#dolphinscheduler #windows #开发环境 #配置

最低0.47元/天解锁文章