Apache DolphinScheduler 3.2.2 版本 MySQL 驱动加载问题分析与解决方案

问题背景

在使用 Apache DolphinScheduler 3.2.2 版本时，用户在执行升级脚本 upgrade-schema.sh 时遇到了两个关键错误：

1. 权限问题导致的 GC 日志文件无法写入
2. 无法加载 MySQL 驱动类 com.mysql.cj.jdbc.Driver

这些问题会阻碍 DolphinScheduler 的正常启动和数据库升级流程。

错误现象详细分析

1. 权限问题

系统报告无法创建 gc.log 文件，错误信息为：

Java 64-Bit Server VM warning: Cannot open file gc.log due to Permission denied

这表明运行 DolphinScheduler 的用户（dolphinscheduler）对目标目录没有足够的写入权限。

2. MySQL 驱动加载问题

系统抛出以下异常链：

Error creating bean with name 'dolphinSchedulerManager'
-> Unsatisfied dependency expressed through constructor parameter 0
-> Error creating bean with name 'v130DolphinSchedulerUpgrader'
-> Error creating bean with name 'dataSource'
-> Cannot load driver class: com.mysql.cj.jdbc.Driver

这表明 Spring Boot 应用在初始化数据源时无法找到并加载 MySQL 的 JDBC 驱动类。

根本原因

1. 权限问题：

   • 运行 DolphinScheduler 的用户对日志目录没有写入权限
   • 虽然用户尝试将文件权限改为 777，但可能没有正确设置父目录的权限

2. MySQL 驱动问题：

   • 虽然用户确认 MySQL 驱动 jar 包（mysql-connector-java-8.0.28.jar）已放置在正确位置，但系统仍无法加载驱动类
   • 可能原因包括：
     • 驱动 jar 包版本与 DolphinScheduler 不兼容
     • 驱动 jar 包损坏
     • 类加载路径配置不正确
     • 依赖冲突导致驱动类被覆盖

解决方案

1. 解决权限问题

确保 dolphinscheduler 用户对以下目录有完全访问权限：

• DolphinScheduler 安装目录
• 日志目录（包括父目录）
• 临时文件目录

具体操作：

chown -R dolphinscheduler:hadoop /path/to/dolphinscheduler
chmod -R 755 /path/to/dolphinscheduler

2. 解决 MySQL 驱动问题

方案一：验证驱动有效性

1. 检查驱动 jar 包的完整性：

   unzip -t mysql-connector-java-8.0.28.jar
   

2. 确认驱动类确实存在于 jar 包中：

   jar tf mysql-connector-java-8.0.28.jar | grep Driver.class
   

方案二：使用兼容的驱动版本

• 尝试使用 DolphinScheduler 官方推荐的 MySQL 驱动版本
• 常见兼容版本包括 8.0.23、8.0.26 等

方案三：检查类加载路径

1. 确认驱动 jar 包被正确加载：
   • 检查 DolphinScheduler 启动脚本中的类路径设置
   • 确保没有其他版本的 MySQL 驱动在类路径中造成冲突

方案四：手动注册驱动 在 DolphinScheduler 的数据库配置中，可以尝试显式指定驱动类加载方式：

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.hikari.driver-class-name=com.mysql.cj.jdbc.Driver

最佳实践建议

1. 权限管理：

   • 为 DolphinScheduler 创建专用的用户和组
   • 合理设置目录权限，避免使用过于宽松的 777 权限

2. 依赖管理：

   • 使用 Maven 或 Gradle 管理依赖，确保版本一致性
   • 定期更新依赖组件，修复已知问题

3. 日志配置：

   • 明确配置日志目录和权限
   • 考虑使用日志轮转策略，避免单个日志文件过大

4. 数据库连接：

   • 测试数据库连接配置是否有效
   • 考虑使用连接池配置优化参数

总结

Apache DolphinScheduler 3.2.2 版本中的 MySQL 驱动加载问题通常与驱动版本、类加载路径或权限设置有关。通过系统地检查这些方面，大多数情况下可以解决问题。对于生产环境，建议遵循最小权限原则，并使用经过验证的组件版本组合，以确保系统稳定运行。

值得注意的是，该问题在 DolphinScheduler 的开发分支(dev)中已经得到修复，用户也可以考虑升级到更新版本以获得更稳定的体验。