当前位置：首页 > news >正文

DolphinScheduler 3.2.0 后端开发环境搭建指南

news 2025/7/7 21:36:15

一、环境准备

二、源码获取

三、源码编译问题解决

四、关键配置修改

五、服务启动

一、环境准备

必需软件
- JDK 8（必须使用 JDK 8）
- Maven 3.6.0+（必须 ≥3.6.0）
- Git
- MySQL 5.7+

版本验证

java -version  # 必须显示 java version "1.8.x"
mvn -v         # 必须显示 Apache Maven 3.6.0+

二、源码获取

克隆仓库并切换分支：

git clone git@github.com:apache/dolphinscheduler.git
cd dolphinscheduler
git checkout 3.2.0  # 必须精确切换到3.2.0分支

三、源码编译问题解决

首次编译命令

mvn clean install -Prelease -Dmaven.test.skip=true

问题1：Spotless格式检查失败 问题现象：编译失败，控制台显示：

[ERROR] Failed to execute goal com.diffplug.spotless:spotless-maven-plugin:2.27.2:check
[ERROR] The following files had format violations:
[ERROR]     pom.xml
[ERROR]         @@ -15,7 +15,8 @@
[ERROR]          ··~·See·the·License·for·the·specific·language·governing·permissions·and
[ERROR]          ··~·limitations·under·the·License.
[ERROR]          ··-->
[ERROR]         -<project·xmlns="http://maven.apache.org/POM/4.0.0"·xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"·xsi:schemaLocation="http://maven.apache.org/POM/4.0.0·http://maven.apache.org/xsd/maven-4.0.0.xsd">
[ERROR]         +<project·xmlns="http://maven.apache.org/POM/4.0.0"·xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
[ERROR]         +·········xsi:schemaLocation="http://maven.apache.org/POM/4.0.0·http://maven.apache.org/xsd/maven-4.0.0.xsd">

问题原因： pom.xml 文件的XML格式不符合规范，Spotless插件强制要求xsi:schemaLocation属性换行显示

解决方案：

./mvnw spotless:apply  # 自动修复格式问题

问题2：Maven版本不兼容 问题现象：使用Maven 3.5.0编译时失败，控制台显示：
```
[ERROR] Failed to execute goal com.github.eirslett:frontend-maven-plugin:1.12.1:install-node-and-pnpm 
[ERROR] The plugin com.github.eirslett:frontend-maven-plugin:1.12.1 requires Maven version 3.6.0
```
问题原因：前端编译插件frontend-maven-plugin强制要求Maven版本≥3.6.0

解决方案：升级Maven到3.6.0+版本

重新编译

mvn clean install -Prelease -Dmaven.test.skip=true

四、关键配置修改

MySQL驱动作用域修改 文件：dolphinscheduler-bom/pom.xml 修改点：
```
<dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><scope>compile</scope>
</dependency>
```
原因：确保编译时包含MySQL驱动

紧接着创建dolphinscheduler数据库，并且dolphinscheduler/dolphinscheduler-dao/src/main/resources/sql/dolphinscheduler_mysql.sqlSQL文件直接在新创建的数据库中执行，初始化数据库。

Master服务配置

数据库配置：dolphinscheduler-master/src/main/resources/application.yaml

spring: datasource:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://127.0.0.1:3306/dolphinschedulerusername: rootpassword: mysql

日志配置：dolphinscheduler-master/src/main/resources/logback-spring.xml 在<root>节点内添加：
```
<appender-ref ref="STDOUT"/>  
```

Worker服务配置
- 日志配置：dolphinscheduler-worker/src/main/resources/logback-spring.xml 添加相同配置：
```
<appender-ref ref="STDOUT"/>
```
API服务配置
- 数据库配置：dolphinscheduler-api/src/main/resources/application.yaml
```
spring: datasource:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://127.0.0.1:3306/dolphinschedulerusername: rootpassword: mysql
```
- 日志配置：dolphinscheduler-api/src/main/resources/logback-spring.xml 添加：
```
<appender-ref ref="STDOUT"/>
```