Apache DolphinScheduler 连接 MySQL 数据库时的公钥检索问题解析

在使用 Apache DolphinScheduler 3.1.x 版本初始化数据库时，部分用户可能会遇到"Public Key Retrieval is not allowed"的错误提示。这个问题本质上是 JDBC 驱动与 MySQL 服务器之间的安全认证机制导致的连接问题。

问题现象

当用户按照官方文档指引，执行数据库初始化脚本时，系统会抛出"Public Key Retrieval is not allowed"的错误信息，导致数据库初始化失败。这种情况通常发生在较新版本的 MySQL 服务器与 JDBC 驱动交互时。

问题根源

这个问题的产生源于 MySQL 8.0 及以上版本默认启用了新的身份验证插件"caching_sha2_password"。该插件在认证过程中需要从服务器获取公钥，而默认情况下 JDBC 驱动出于安全考虑禁止了公钥检索功能。

解决方案

要解决这个问题，需要在 JDBC 连接字符串中添加特定的参数配置：

allowPublicKeyRetrieval=true

这个参数明确允许 JDBC 驱动从服务器检索公钥，从而完成身份验证过程。完整的连接字符串示例如下：

jdbc:mysql://localhost:3306/dolphinscheduler?useUnicode=true&characterEncoding=UTF-8&allowPublicKeyRetrieval=true

安全考量

虽然这个解决方案能够解决问题，但从安全角度考虑需要注意以下几点：

1. 仅在可信网络环境中使用此参数
2. 建议配合SSL加密连接使用
3. 生产环境中应考虑其他更安全的认证方式

最佳实践

对于生产环境部署，建议采取以下措施：

1. 配置MySQL使用传统认证插件(mysql_native_password)
2. 使用SSL加密连接
3. 在应用服务器和数据库服务器之间建立专用网络通道
4. 定期轮换数据库凭据

通过以上配置和最佳实践，可以在保证安全性的前提下，顺利解决 DolphinScheduler 连接 MySQL 时的公钥检索问题。