JeecgBoot动态数据源连接超时问题分析与解决方案

问题现象

在使用JeecgBoot 3.7.0版本时，开发人员通过DynamicDBUtil.getDbSourceByDbKey方法获取动态数据源连接时，发现系统运行一段时间后会出现连接超时问题。具体表现为：

1. 初始阶段连接正常
2. 运行一段时间后连接失败
3. 重新编辑保存数据源配置后问题暂时解决

问题本质分析

这个问题实际上是由于数据库连接池管理机制导致的典型连接资源耗尽现象。具体原因包含以下几个方面：

1. 连接数超过最大限制：当并发请求量较大时，连接池中的活跃连接数达到了配置的最大值(maxActive)

2. 闲置连接被回收：数据库连接池中的连接在闲置时间(idleTime)达到设定阈值后会被自动释放

3. 连接泄漏：应用程序可能没有正确关闭连接，导致连接无法返回到连接池

解决方案

1. 调整连接池参数

这是最直接的解决方案，通过优化连接池配置参数来缓解问题：

# 增大最大连接数
spring.datasource.druid.max-active=50

# 增大最小空闲连接数
spring.datasource.druid.min-idle=10

# 延长连接最大存活时间
spring.datasource.druid.max-age=1800000

# 增大连接在池中的最小生存时间
spring.datasource.druid.min-evictable-idle-time-millis=300000

2. 优化应用代码

确保在使用完数据库连接后正确关闭资源：

try {
    Connection conn = DynamicDBUtil.getDbSourceByDbKey(dbKey);
    // 业务逻辑处理
} finally {
    if(conn != null) {
        try {
            conn.close();
        } catch(SQLException e) {
            log.error("关闭连接异常", e);
        }
    }
}

3. 监控连接池状态

建议集成连接池监控功能，可以实时查看：

• 活跃连接数
• 空闲连接数
• 等待获取连接的线程数
• 连接获取最大等待时间

4. 定期维护机制

对于长期运行的系统，可以考虑实现：

1. 定时检测连接池健康状态
2. 自动重置异常连接
3. 连接泄漏检测与告警

最佳实践建议

1. 合理设置连接池参数：根据实际业务负载情况调整参数，避免过大或过小

2. 实施连接泄漏检测：在测试环境中开启连接泄漏检测功能

3. 建立监控告警：对连接池关键指标设置阈值告警

4. 定期维护：对于重要系统，定期重启应用可以释放潜在问题

5. 考虑使用连接池健康检查：配置连接池的健康检查SQL，确保连接有效性

通过以上措施，可以有效解决JeecgBoot动态数据源连接超时问题，并提升系统稳定性。