Apache DolphinScheduler 使用常见问题总结(持续更新中)

一子三木

墨衍会员 · AI 创作全网分发码龄16年

关注

VIP免费原创最新推荐文章于 2026-06-29 18:59:17 发布 5.2w 阅读 AI 写同款· GEO 优化 ›

限时加码！20+主流AI编程工具免费用购周边加赠Coding Plan Lite，Claude Code、Cursor等即刻畅享，学习进阶更高效！阅读详情

DolphinScheduler 使用常见问题总结

说明
- - - 使用注意事项
    - - 安装包与安装目录
      - 日志查看目录
开发环境常见问题
调度部署常见问题
- - - ubuntu 部署报错 source: not found
    - 访问API服务报错404
调度使用常见问题

说明

文章中常见问题是在使用过程中发现的，如果文章没有你遇到的问题，请到github上提交issue。

官网地址

github issue地址

使用注意事项

安装包与安装目录

	安装包：是下载的的源文件，只有在安装时候才会用到，相安装好调度可以删除该目录。
	安装目录：运行install.sh后调度安装的目录，对调度管理都在安装目录下操作，比如 启停服务，、配置、查看日志等等。
	官网文档中的描述如下（配置在install.sh中），**记住**任何操作都在安装目录下操作。

 #将DS安装到哪个目录，如: /opt/soft/dolphinscheduler，不同于现在的目录
  installPath="/opt/soft/dolphinscheduler"

日志查看目录

假设安装调度时候安装配置为 installPath="/opt/soft/dolphinscheduler"，那么日志目录就在
/opt/soft/dolphinscheduler/logs 下

查看worker 日志
tail -f /opt/soft/dolphinscheduler/logs/dolphinscheduler-worker.log

查看master日志
tail -f /opt/soft/dolphinscheduler/logs/dolphinscheduler-master.log

查看api 日志

tail -f /opt/soft/dolphinscheduler/logs/dolphinscheduler-api-server.log

查看告警alert日志

tail -f /opt/soft/dolphinscheduler/logs/dolphinscheduler-alert.log

查看日志服务logger日志

tail -f /opt/soft/dolphinscheduler/logs/dolphinscheduler-logger-server-huaweiyun.out

huaweiyun为hostname,自行修改成你本地的

开发环境常见问题

API启动端口是8080不是12345

在初始化环境中api默认配置12345，
解决办法
编辑运行配置，增加如下配置

-Dserver-api-server -Dspring.profiles.active=api

在这里插入图片描述

找不到mysql驱动

由于DolphinScheduler 默认使用的postgresql,默认没有引入mysql驱动依赖。需要手动修改pom。

解决办法:
找到根目录下pom.xml的

<dependency>
	<groupId>mysql</groupId>
	<artifactId>mysql-connector-java</artifactId>
	<version>${mysql.connector.version}</version>
	<scope>test</scope>
</dependency>

去掉 < scope>test< /scope> 就ok

在这里插入图片描述

重新 import maven依赖。

worker 执行失败报NPE空指针

在这里插入图片描述

解决办法:
在WorkServer vm options 添加如下参数

-Dspring.profiles.active=worker -Dlogging.config=“dolphinscheduler-server/src/main/resources/logback-worker.xml”

在这里插入图片描述
如果报文件找不到去掉双引号

-Dspring.profiles.active=worker -Dlogging.config=dolphinscheduler-server/src/main/resources/logback-worker.xml

调度部署常见问题

ubuntu 部署报错 source: not found

在这里插入图片描述

解决办法

可以百度google 关键词 ubuntu source: not found 里面有解决方案

访问API服务报错404

在这里插入图片描述

解决办法

上面请求少了工程名称，完整地址是 http://ip:12345/dolphinscheduler/

API默认端口12235

调度使用常见问题

系统初始化登录失败

一般这个错就是密码记错了，调度初始密码如下,注意拷贝不要有空格
账号: admin
密码: dolphinscheduler123

监控页面Master Worker 页面一直都在努力加载中或者查询无数据

通过命令jps,能看到WorkerServer和MasterServer进程。有可能的原因zk挂掉了。
在这里插入图片描述

解决办法

查看zk是否启动。如果没有启动就把zk服务启动好。再监控页面看看Master Worker 状态

工作流手动运行成功，但是任务实例页面没有数据

这个问题因素比较多，先假设 zk,worker master 都启动成功情况下
通过查看worker日志，发现有日志 load or availablePhysicalMemorySize(G) is too high，问题同后面的问题load or availablePhysicalMemorySize(G) is too high