Java定时任务怎么设置只跑一次？成功调用后自动关闭的方法

前言

对接方给了一个 URL，说一般是每天下午 18 点后会更新这个地址，但具体时间不确定。

一开始的思路是直接用 @Scheduled 注解来开发，但需求是：只需要成功调用一次这个 URL，之后就不再跑这个定时任务；如果调用失败，则每隔几分钟再试一次，直到某个时间点截止。

基本的定时任务

//每天下午18点执行
@Scheduled(cron = "0 0 18 * * ?")
    public void syncForecast(){
        stdService.syncForecast();
    }

代码实现

根据实际需求修改时间范围即可。

 public void syncForecast() {
        ScheduledExecutorService scheduler = Executors.newScheduledThreadPool(1);
        Runnable task = () -> {
            LocalTime now = LocalTime.now();
            LocalTime startTime = LocalTime.of(18, 0); // 18:00
            LocalTime endTime = LocalTime.of(23, 59);  // 23:59

            // 判断当前时间是否在 18:00 到 23:59 之间
            if (now.isAfter(startTime) && now.isBefore(endTime)) {
                // 调用接口并获取返回结果，在此处编写判断是否满足条件然后结束定时任务的逻辑
                boolean result = callApi1();
                // 如果接口返回结果满足条件，取消当天任务
                if (result) {
                    scheduler.shutdown(); // 取消任务
                }
            } else {
                scheduler.shutdown(); // 取消任务
            }
        };
        // 计算首次执行时间（延迟到当天的 18:00）
        long initialDelay = calculateInitialDelay(18);
        long period = 5; // 每 5 分钟执行一次
        // 定时任务
        scheduler.scheduleAtFixedRate(task, initialDelay, period, TimeUnit.MINUTES);
    }

后话

当然，也可以用 xxl-job 来实现。不过因为在内网环境，导依赖比较麻烦，所以这次没有考虑。

总结

以上方案结合了时间窗口判断和重试机制，能够满足“成功一次即停止，失败则持续重试直到时间窗口结束”的需求。实际使用时，可以根据接口的幂等性和业务场景调整重试间隔和截止时间。