
## 一、整体架构概览
DolphinScheduler 的插件体系基于 Java SPI（Service Provider Interface） 机制，配合 Google AutoService 自动生成注册文件，实现了零侵入的插件化扩展

```
dolphinscheduler-spi                    ← 核心接口层（SPI基础设施）
dolphinscheduler-datasource-plugin      ← 数据源插件层
dolphinscheduler-task-plugin            ← Task插件层
dolphinscheduler-worker                 ← 插件消费层（Worker执行任务）
```
## 二、SPI 基础设施
```
PrioritySPI (接口)
  └── getIdentify(): SPIIdentify  ← 插件唯一标识 + 优先级
  └── compareTo(Integer)          ← 优先级比较
```
PrioritySPIFactory<T> 是插件发现的核心引擎
```
通过 Java 标准 ServiceLoader 扫描 classpath
for (T t : ServiceLoader.load(spiClass)) {
    if (map.containsKey(t.getIdentify().getName())) {
        resolveConflict(t);   // 同名插件按优先级决策，优先级相同则抛异常
    } else {
        map.put(t.getIdentify().getName(), t);
    }
}
```
**插件注册方式**：每个插件模块使用 @AutoService 注解，编译时自动在 META-INF/services/ 下生成 SPI 配置文件，无需手动维护

## 三、数据源插件详细流程
### 3.1 接口层次结构
```
DataSourceChannelFactory (SPI入口)
  └── getName()          ← 插件唯一名称，如 "MYSQL"
  └── create()           ← 创建 DataSourceChannel

DataSourceChannel (通道)
  └── createAdHocDataSourceClient()    ← 创建临时连接客户端
  └── createPooledDataSourceClient()   ← 创建连接池客户端

DataSourceClient (基础接口)
  └── getConnection(): Connection

PooledDataSourceClient extends DataSourceClient
  └── createDataSourcePool()           ← 创建 HikariCP 连接池
```
### 3.2 以 MySQL 为例的完整实现链
```
MySQLDataSourceChannelFactory          ← @AutoService 注册
  └── create() → MySQLDataSourceChannel
        └── createPooledDataSourceClient() → MySQLPooledDataSourceClient
              └── extends BasePooledDataSourceClient
                    └── createDataSourcePool() → HikariDataSource
                          ├── setDriverClassName()
                          ├── setJdbcUrl()
                          ├── setUsername() / setPassword()
                          ├── setMinimumIdle() / setMaximumPoolSize()
                          └── setConnectionTestQuery()
```
## 四、Task 插件详细流程
### 4.1 接口层次结构
```
TaskChannelFactory (SPI入口) extends UiChannelFactory, PrioritySPI
  └── getName()          ← 插件类型名，如 "SHELL"
  └── create()           ← 创建 TaskChannel
  └── getParams()        ← 返回 UI 配置参数（前端渲染用）

TaskChannel (通道)
  └── createTask(TaskExecutionContext) → AbstractTask
  └── parseParameters(ParametersNode) → AbstractParameters
  └── getResources(parameters)        → ResourceParametersHelper
  └── cancelApplication(boolean)

AbstractTask (任务执行基类)
  └── init()             ← 初始化
  └── handle(callback)   ← 执行（抽象）
  └── cancel()           ← 取消（抽象）
  └── getExitStatus()    ← 根据 exitCode 返回状态
```
### 4.2 以 Shell 为例的完整实现链
```
ShellTaskChannelFactory                ← @AutoService 注册
  └── getName() → "SHELL"
  └── getParams() → [nodeName, runFlag, ...]  ← 前端UI参数
  └── create() → ShellTaskChannel
        └── createTask(ctx) → ShellTask
              └── handle(callback)
                    └── ShellCommandExecutor.run(shellActuatorBuilder)
                          └── 执行 Shell 脚本进程
```
### 五、两种插件的关键对
![](https://developer.qcloudimg.com/http-save/yehe-11849333/dcc7a6f92517fd9e5321c48074dd6039.jpg)


DolphinScheduler 的插件体系基于 Java SPI（Service Provider Interface） 机制，配合 Google AutoService 自动生成注册文件，实现了零侵入的插件化扩展

一文读懂DolphinScheduler插件机制：如何轻松扩展任务类型与数据源

编程语言

数据库

架构设计

DolphinScheduler采用Java SPI机制实现插件化架构，支持数据源和任务插件扩展。通过@AutoService自动注册，核心层提供PrioritySPI优先级管理，数据源插件实现连接池管理，任务插件支持自定义执行逻辑，实现零侵入扩展。

代码解释

MySQL

Java

2026上云采购 | AI焕新·智启新局

bigdata-class

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

一文读懂DolphinScheduler插件机制：如何轻松扩展任务类型与数据源-腾讯云开发者社区-腾讯云

一文读懂DolphinScheduler插件机制：如何轻松扩展任务类型与数据源

一文读懂DolphinScheduler插件机制：如何轻松扩展任务类型与数据源

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐