XXL-JOB数据库连接问题排查与解决方案

问题背景

在使用XXL-JOB调度系统v2.3.0版本时，开发者在本地启动xxl-job-admin服务时遇到了数据库连接被拒绝的问题。尽管数据库客户端工具可以正常访问，但应用程序却无法建立连接，并出现了IP地址被莫名替换的现象。

问题现象

1. 配置文件中指定了正确的MySQL服务器IP地址(192.168.110.106)
2. 数据库用户(yxw01)和密码(yxw@123!)确认无误
3. 数据库版本为MySQL 8.0+
4. 错误日志显示连接被拒绝，且连接IP被替换为192.168.110.3

错误分析

从日志中可以观察到几个关键点：

1. IP地址被替换：配置中指定的192.168.110.106在实际连接时被替换为192.168.110.3
2. 认证失败：错误明确提示"Access denied for user 'yxw01'@'192.168.110.3'"
3. 连接池配置：HikariCP连接池初始化成功，但无法建立实际连接

可能原因

1. 数据库用户权限问题：MySQL用户yxw01可能没有从192.168.110.3访问的权限
2. 网络配置问题：可能存在网络代理或NAT转换导致IP被修改
3. 连接字符串问题：URL参数可能存在特殊字符处理问题
4. 环境变量覆盖：可能存在环境变量或系统属性覆盖了配置文件的设置

解决方案

经过多次尝试，开发者发现以下两种配置方式可以解决问题：

方案一：使用环境变量占位符

spring.datasource.url=jdbc:mysql://${MYSQL_HOST:hy-mysql}:${MYSQL_PORT:3306}/${DB_NAME:xxl_job}?useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull&serverTimezone=Asia/Shanghai&useSSL=false
spring.datasource.username=yxw01
spring.datasource.password=yxw@123!
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

方案二：使用本地回环地址

spring.datasource.url=jdbc:mysql://127.0.0.1:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai
spring.datasource.username=yxw01
spring.datasource.password=yxw@123!
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

深入解析

1. URL参数差异：成功方案的URL中包含了useSSL=false参数，这在MySQL 8.0+中通常是必要的
2. 特殊字符处理：密码中的特殊字符(@)可能需要额外处理
3. 时区设置：两个方案都正确设置了serverTimezone参数，这对于MySQL 8.0+很重要
4. 连接池配置：HikariCP的默认配置在两种方案下都能正常工作

最佳实践建议

1. 完整的URL参数：建议在连接MySQL 8.0+时至少包含以下参数：

   • useUnicode=true
   • characterEncoding=UTF-8
   • serverTimezone=Asia/Shanghai
   • useSSL=false

2. 密码安全：避免在密码中使用特殊字符，或确保它们被正确转义

3. 权限检查：确保数据库用户有从应用服务器IP访问的权限

4. 环境隔离：使用环境变量占位符可以使配置在不同环境中更灵活

总结

XXL-JOB作为一款优秀的分布式任务调度系统，其数据库连接问题通常源于MySQL 8.0+的安全增强特性或网络配置问题。通过合理配置连接字符串参数和确保正确的访问权限，可以解决大多数连接问题。对于生产环境，建议使用方案一的环境变量方式，便于不同环境的配置管理。