JeecgBoot积木报表中SQL数据集使用存储过程导致连接池泄漏问题分析

问题背景

在JeecgBoot 3.6.2版本中集成的积木报表1.7.8版本，当用户在使用SQL数据集功能调用存储过程时，系统会出现数据库连接池资源泄漏的问题。具体表现为每次预览报表都会占用一个Druid连接池连接且不会释放，最终导致连接池耗尽，系统无法继续访问数据库。

问题现象

用户在使用SQL数据集功能时发现：

1. 当SQL数据集中编写普通SQL查询语句时，系统运行正常，连接能够正确释放
2. 当SQL数据集中调用存储过程时，每次预览操作都会占用一个数据库连接且不会释放
3. 随着预览次数的增加，Druid连接池中的可用连接逐渐减少
4. 当连接池被完全占用后，系统会出现数据库连接超时错误

技术分析

连接池泄漏原理

数据库连接池泄漏是指应用程序从连接池中获取连接后，未能正确释放回连接池的情况。在Java中，通常需要遵循"获取-使用-关闭"的模式来使用数据库连接。如果程序在获取连接后没有调用close()方法，或者close()方法没有被正确执行，就会导致连接泄漏。

存储过程调用的特殊性

与普通SQL查询相比，存储过程调用有以下特点：

1. 可能返回多个结果集
2. 可能包含输出参数
3. 执行流程可能更复杂
4. 可能需要特殊的方式来关闭相关资源

在积木报表的实现中，处理普通SQL查询时能够正确关闭连接，但处理存储过程时可能没有考虑到这些特殊性，导致相关资源未能正确释放。

解决方案

项目维护团队已经确认并修复了此问题，修复方案可能包括：

1. 确保在存储过程执行完毕后显式关闭所有相关资源
2. 使用try-with-resources语句确保资源释放
3. 对存储过程调用的结果集进行完整遍历以确保底层连接可以被释放
4. 在finally块中确保连接的关闭操作

用户应对措施

对于遇到此问题的用户，可以采取以下临时解决方案：

1. 升级到包含修复的新版本
2. 在等待新版本发布期间，可以考虑：
   • 暂时避免在SQL数据集中使用存储过程
   • 适当增大Druid连接池的最大连接数
   • 设置合理的连接超时时间

最佳实践建议

1. 在使用存储过程时，确保在代码中正确处理所有可能的结果集
2. 使用连接池时，建议配置合理的监控和泄漏检测参数
3. 对于复杂的数据库操作，建议进行充分的资源管理测试
4. 定期检查数据库连接池的使用情况，及时发现潜在问题

总结

数据库连接池泄漏是Java应用中常见的问题之一，特别是在处理存储过程等复杂数据库操作时更容易出现。积木报表团队已经识别并修复了这一问题，用户可以通过升级到新版本获得修复。在日常开发中，开发者应当重视资源管理，确保数据库连接等稀缺资源能够被正确释放。