如何在 Java 中利用 java.util.Timer 实现每隔 5 秒执行一次的后台清理任务

在Ja va里用 Timer 做定时清理，听起来再简单不过了。但很多上线后踩的坑，往往就出在“看似简单”这三个字上。先锚定一个核心结论：Timer.schedule() 的正确调用一定要用三参数版本——传入 TimerTask 实例，首次延迟0毫秒，周期5000毫秒；它按上一次执行结束开始计时，能有效避免任务堆积；而 scheduleAtFixedRate() 在某些场景下会疯狂追赶触发，风险不小。别忘了显式调用 cancel() 防止泄漏，更稳妥的做法是换成 ScheduledExecutorService。

Timer.schedule() 的正确调用方式

Timer 本身不干活，真正驱动周期性行为的是 Timer.schedule()。它有一堆重载，但要想实现“每隔5秒执行一次”，必须用那个带3个参数的版本：任务本身、首次延迟、周期间隔（单位是毫秒）。首次延迟设为0，表示立刻开始；周期写成 5000，千万别写成 5——单位换算这种低级错误，排查起来真要命。

• 必须传入 TimerTask 子类的实例，直接塞 Runnable 是行不通的
• 首次延迟为0完全合法，不会抛异常
• 周期值如果小于等于0，任务要么只跑一次，要么直接抛 IllegalArgumentException
• 当系统负载高，或者前一次任务执行时间超过5秒时，后续执行会“排队堵车”，不会并发——这是 Timer 单线程模型带来的天然限制

Timer timer = new Timer("cleanup-timer", true); // true 表示守护线程
timer.schedule(new TimerTask() {
    public void run() {
        System.out.println("清理中...");
        // 实际清理逻辑
    }
}, 0, 5000);

为什么不能用 Timer.scheduleAtFixedRate()？

scheduleAtFixedRate() 光看名字似乎更匹配“固定频率”的含义，但它在任务执行超时时会尝试“追赶”，可能短时间内密集触发多次，对清理类任务来说隐患极大。举个例子：一次磁盘扫描耗时8秒，如果用 scheduleAtFixedRate()，它会在第5秒、第10秒、第13秒……疯狂补发执行，而 schedule() 严格遵循“上一次执行结束 + 5秒”的节奏，可控得多。

• 清理任务往往有副作用（删文件、释放连接），追赶式调度不适合
• schedule() 的间隔是从上一次 run() 返回才开始计时，更贴合“每5秒做一次”的直觉
• 如果真的需要严格固定周期（比如心跳上报），才考虑 scheduleAtFixedRate()，前提是确保任务绝对轻量

Timer 线程泄漏和 shutdown 的坑

Timer 内部维护着一个非守护线程（除非你显式指定为守护线程），只要不调用 cancel()，JVM 就休想退出。后台清理任务如果随服务生命周期存在，服务关闭时必须显式终止它。

• 创建时加 true 参数（如 new Timer("name", true)）让它变成守护线程，可以避免阻塞 JVM 退出，但资源未释放的问题依然存在
• 正确的做法是在应用关闭钩子或 Spring 的 @PreDestroy 中调用 timer.cancel()
• cancel() 并不会中断正在运行的 run()，只是取消待执行的任务；已经启动的任务需要自行处理中断或超时逻辑
• 多次调用 cancel() 是安全的，但之后再调用 schedule() 就会抛出 IllegalStateException

比 Timer 更稳的选择：ScheduledExecutorService

Timer 算是老古董了，单线程模型脆弱得一塌糊涂：只要一个任务抛了未捕获异常，整个调度器就悄无声息地停摆。而 ScheduledExecutorService（比如 Executors.newSingleThreadScheduledExecutor()）可以捕获并吞掉异常，保证后续任务继续运行。

• 用 scheduleAtFixedRate() 或 scheduleWithFixedDelay() 替代，后者语义等价于 Timer.schedule()
• 支持线程池配置、任务拒绝策略，生命周期管理也清晰得多（shutdown() / awaitTermination()）
• 如果项目已经用了 Spring，直接用 @Scheduled(fixedDelay = 5000) 更省心，底层默认走 ScheduledExecutorService

ScheduledExecutorService scheduler = Executors.newSingleThreadScheduledExecutor(
    r -> new Thread(r, "cleanup-scheduler"));
scheduler.scheduleWithFixedDelay(() -> {
    System.out.println("清理中...");
}, 0, 5000, TimeUnit.MILLISECONDS);

Ja va 里定时清理这种事，关键还真不在“怎么写第一行”，而在于“谁负责关、异常怎么兜、下次还能不能跑”。Timer 看着简单，但它的线程模型和错误传播机制，很容易在上线后给你来个“惊喜”。