Java Cleaner 类（超详细）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在 Java 的资源管理领域，开发者长期依赖手动关闭或 try-with-resources 语法来确保非内存资源（如文件句柄、网络连接、数据库连接等）的及时释放。然而，当系统复杂度提升时，手动管理容易引发资源泄漏风险。为解决这一痛点，Java 9 引入了 Cleaner 类——一个通过引用对象和线程池实现自动资源回收的机制。本文将深入剖析 Cleaner 类的核心原理、使用场景及最佳实践，帮助开发者构建更健壮的应用程序。

什么是 Java Cleaner 类？

Cleaner 类是 Java 平台提供的一个工具类，旨在简化非内存资源的自动释放流程。它通过关联对象的生命周期，确保资源在对象被垃圾回收时自动清理，从而避免手动关闭的繁琐操作。

核心概念解析

1. PhantomReference：
   Cleaner 内部依赖 PhantomReference 对象来追踪目标资源。当目标对象不再被强引用时，PhantomReference 会将自身加入 ReferenceQueue，触发后续清理操作。
   比喻： 可以将 PhantomReference 想象为一个“清洁工”，它会定期检查街道（堆内存）上是否有无人认领的垃圾（废弃对象），并通知清洁队（线程池）进行清理。

2. ReferenceQueue：
   这是一个队列，用于存储被回收对象的引用。当 PhantomReference 检测到目标对象被回收时，它会将自身放入该队列中，等待线程处理。

3. 线程池：
   Cleaner 使用单线程的 ForkJoinPool 来执行资源清理任务。该线程会定期检查 ReferenceQueue，并调用与之关联的清理方法（如关闭文件流或释放数据库连接）。

Cleaner 类的工作原理

Cleaner 的核心逻辑可归纳为以下步骤：

1. 注册资源：
   开发者需通过 Cleaner.create() 方法将资源对象与清理任务绑定。例如：

   public class FileResource {
       private final File file;
       private final Cleaner.Cleanable cleanable;
   
       public FileResource(String path) {
           this.file = new File(path);
           this.cleanable = Cleaner.create(this, () -> {
               if (file.exists()) {
                   file.delete();
               }
           });
       }
   }
   

   此时，Cleaner 会为 FileResource 实例创建一个 PhantomReference，并将其加入 ReferenceQueue。

2. 触发清理：
   当 FileResource 对象被垃圾回收时，PhantomReference 会通知 ReferenceQueue。线程池中的工作者线程随后会取出该引用，并执行关联的清理逻辑（如删除文件）。

3. 资源回收：
   清理任务完成后，PhantomReference 会被移除，确保资源完全释放。

实际应用场景与案例分析

场景 1：文件句柄的自动释放

在文件操作中，若未及时关闭 FileInputStream 或 FileOutputStream，可能导致系统句柄耗尽。使用 Cleaner 可自动处理此类问题：

public class AutoCloseFile {
    private final File file;
    private final FileInputStream fis;
    private final Cleaner.Cleanable cleanable;

    public AutoCloseFile(String path) throws FileNotFoundException {
        this.file = new File(path);
        this.fis = new FileInputStream(file);
        this.cleanable = Cleaner.create(this, () -> {
            try {
                if (fis != null) fis.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        });
    }
}

当 AutoCloseFile 对象被回收时，FileInputStream 将自动关闭，无需手动调用 close() 方法。

场景 2：数据库连接的优雅关闭

在数据库操作中，Connection 对象的泄漏可能导致线程池阻塞。通过 Cleaner 可实现连接的自动归还：

public class DatabaseConnection {
    private final Connection connection;
    private final Cleaner.Cleanable cleanable;

    public DatabaseConnection() throws SQLException {
        this.connection = DriverManager.getConnection("jdbc:mysql://localhost/test");
        this.cleanable = Cleaner.create(this, () -> {
            try {
                if (connection != null && !connection.isClosed()) {
                    connection.close();
                }
            } catch (SQLException e) {
                e.printStackTrace();
            }
        });
    }
}

即使未显式关闭连接，对象被回收时资源仍会释放。

开发者需注意的细节

1. 避免手动干预清理逻辑

Cleaner 的清理任务由 JVM 自动触发，开发者应避免手动调用 cleanable.clean() 方法。例如：

// 错误示例：重复清理可能导致 NPE
public void close() {
    if (cleanable != null) {
        cleanable.clean(); // 不推荐！
    }
}

正确做法： 通过 try-with-resources 或 AutoCloseable 接口实现显式关闭，同时保留 Cleaner 作为兜底机制。

2. 确保清理任务线程安全

由于清理任务由单独线程执行，需保证资源访问的线程安全性。例如：

// 正确示例：使用 volatile 确保可见性
private volatile Connection connection;
private final Cleaner.Cleanable cleanable = Cleaner.create(this, () -> {
    if (connection != null) connection.close();
});

与传统资源管理方式的对比

总结与展望

Java Cleaner 类 通过结合引用队列与线程池技术，为开发者提供了一种优雅的资源自动回收方案。它特别适用于需要长期存活的对象（如缓存、连接池）的场景，降低了资源泄漏的风险。然而，开发者仍需注意线程安全及避免手动干预清理流程。随着 Java 生态的演进，Cleaner 的应用场景将更加广泛，建议在需要自动资源管理的复杂系统中优先考虑其使用。

通过本文的讲解，希望读者能够理解 Java Cleaner 类 的设计思想与实现细节，并在实际项目中灵活运用这一工具，提升代码的健壮性与可维护性。