Rundeck数据库连接池问题分析与解决方案

问题背景

Rundeck是一款开源的自动化运维工具，在5.3.0版本升级后，许多用户报告在高并发作业执行时出现数据库连接池耗尽的问题。该问题表现为作业执行失败，并伴随"HikariPool-1 - Connection is not available, request timed out after 30000ms"的错误日志。

问题现象

当系统同时运行10个或更多作业时，会出现以下典型错误：

1. 数据库连接超时错误
2. 作业执行失败
3. 日志中显示Hikari连接池达到最大限制

根本原因分析

该问题源于Rundeck 5.3.0版本中的一项变更：移除了Tomcat JDBC连接池组件，转而使用HikariCP作为默认连接池。HikariCP默认的最大连接数(maximumPoolSize)为10，这远低于许多生产环境的需求。

在之前的版本中，用户可以通过dataSource.properties.maxActive参数配置连接池大小，但在5.3.0版本中，这个参数不再生效，导致在高并发场景下连接池迅速耗尽。

解决方案

临时解决方案

对于5.3.0版本，可以通过以下方式调整连接池大小：

1. 在rundeck-config.properties文件中添加：

dataSource.properties.maximumPoolSize=100

2. 对于Docker用户，可以通过环境变量设置：

-e JAVA_OPTS="-DdataSource.properties.maximumPoolSize=100"

永久解决方案

Rundeck团队已在5.4.0版本中修复了这个问题，建议用户升级到最新版本。

技术细节

HikariCP是一个高性能的JDBC连接池实现，相比Tomcat JDBC Pool具有以下特点：

1. 更轻量级
2. 更高的性能
3. 更严格的默认配置
4. 不同的配置参数命名规范

在迁移到HikariCP后，原有的连接池配置参数需要相应调整：

• maxActive → maximumPoolSize
• maxWait → connectionTimeout
• 其他相关参数也需要按照HikariCP的规范进行调整

最佳实践建议

1. 根据实际并发需求合理设置连接池大小
2. 监控数据库连接使用情况
3. 定期检查连接泄漏
4. 考虑使用连接池监控工具
5. 在升级前测试新版本的连接池行为

总结

数据库连接池配置是Rundeck性能调优的重要环节。通过理解不同连接池实现的特性，并根据实际工作负载进行适当配置，可以确保系统在高并发情况下的稳定运行。对于遇到类似问题的用户，建议首先调整连接池大小参数，并计划升级到已修复该问题的版本。