必须在应用卸载时显式反注册oracledriver,否则每次热部署都会导致webappclassloader及其加载的oracle.jdbc.driver.oracledriver、oracle.sql.*等类滞留在permgen或metaspace,形成系统类加载器→driver→webappclassloader反向强引用链,最终引发outofmemoryerror;仅靠jdbc 4.0自动注册机制或system.setproperty无效,须在contextdestroyed()中遍历并安全deregister,同时清理线程上下文类加载器和连接池。
必须在应用卸载时显式反注册 oracledriver,否则每次热部署都会让 webappclassloader 及其加载的全部类(包括 oracle.jdbc.driver.oracledriver、oracle.sql.* 等)滞留在永久代(java 7/8)或元空间(java 9+),最终触发 java.lang.outofmemoryerror: permgen space 或 metaspace 溢出。
为什么 DriverManager.registerDriver() 会导致类加载器泄漏
Oracle JDBC 驱动在初始化时会调用 DriverManager.registerDriver(new OracleDriver()),而 DriverManager 是由 BootstrapClassLoader 加载的系统类,它持有一个 CopyOnWriteArrayList<driverinfo></driverinfo> 强引用列表。由于 OracleDriver 实例由当前 WebAppClassLoader 加载,这就形成了:系统类加载器 → DriverInfo → OracleDriver 实例 → WebAppClassLoader 的反向强引用链。只要该链存在,整个类加载器及其所有已加载类都无法被回收。
即使你用了 JDBC 4.0+ 的 META-INF/services/java.sql.Driver 自动发现机制,它也只负责注册,不负责反注册——JVM 不会自动清理。
- 现象:连续 3–5 次 Tomcat 热部署后,
jstat -permstat <pid></pid>显示oracle.开头的类数量翻倍 - 验证:用
jmap -histo:live <pid> | grep oracle</pid>查看oracle.jdbc.driver.OracleDriver实例数是否持续增长 - 注意:
System.setProperty("jdbc.drivers", "")完全无效,它不影响已注册的驱动实例
在 contextDestroyed() 中安全反注册 OracleDriver
必须在 ServletContextListener.contextDestroyed() 或等效生命周期钩子中执行反注册逻辑,且要处理异常和多驱动共存场景。
- 不要遍历
DriverManager.getDrivers()后直接调用deregisterDriver()—— 若其他驱动(如 H2、PostgreSQL)已失效,会抛SQLException导致后续逻辑跳过 - 应先检查驱动类型:
if (driver instanceof oracle.jdbc.driver.OracleDriver),再调用DriverManager.deregisterDriver(driver) - 推荐用 Enumeration 遍历并捕获每个
SQLException,避免单个失败中断全部清理 - 示例代码片段:
public void contextDestroyed(ServletContextEvent sce) {
Enumeration<driver> drivers = DriverManager.getDrivers();
while (drivers.hasMoreElements()) {
Driver driver = drivers.nextElement();
if (driver instanceof oracle.jdbc.driver.OracleDriver) {
try {
DriverManager.deregisterDriver(driver);
} catch (SQLException ignored) { }
}
}
}</driver>
额外必须清理的残留项
仅反注册驱动还不够。Oracle 驱动内部可能启动后台线程、持有静态缓存、或污染当前线程上下文类加载器(Thread.currentThread().setContextClassLoader(null))。
- 调用
oracle.jdbc.pool.OracleDataSource.close()(如果你用了OracleDataSource) - 显式清除当前线程的上下文类加载器:
Thread.currentThread().setContextClassLoader(null),尤其在异步任务或定时器中容易遗漏 - 如果使用了连接池(如 DBCP、HikariCP),确认池已关闭且未持有对
OracleDriver的隐式引用;HikariCP 从 v3.4.0 起默认在 close() 时尝试 deregister,但仍建议手动补一刀 - Java 9+ 用户注意:
PermGen已被Metaspace替代,泄漏表现变为java.lang.OutOfMemoryError: Metaspace,但根本原因和修复方式完全一致
最易被忽略的一点:这个泄漏不会在单次运行中暴露,只有在容器内反复重部署(哪怕只是改一行日志)才会指数级累积。线上环境若从不重启,几个月后 Metaspace 占满是常态——不是内存配少了,是驱动没卸干净。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











