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 实现类似功能，但由于内网环境依赖导入较为繁琐，本次未采用该方案。

总结

上述方案融合了时间窗口判断与重试机制，能够精准满足“成功一次即停止，失败则持续重试直至时间窗口截止”的业务要求。在实际应用中，可根据接口的幂等性及业务场景，灵活调整重试间隔与截止时间。