如何在Spring Boot中实现定时任务，每月向不同时区用户发送邮件？

1. 调度触发器基础配置 #

首先配置Spring调度器的默认时区为UTC，保证触发时间全球统一，避免服务端本地时区影响执行时机：

• 在application.yml/properties中添加配置：spring.task.scheduling.timezone=UTC
• 调度任务触发cron表达式设置为每月1号UTC零点执行，确保此时全球所有时区的上月均已结束：@Scheduled(cron = "0 0 0 1 * ?")

2. 核心逻辑实现步骤 #

2.1 前置依赖准备 #

• 管理员用户表新增timezone_id字段，存储IANA标准时区ID（如Asia/Kolkata、America/New_York），禁止存储固定偏移量，可自动适配夏令时调整。
• 新增存储统计结果的Mongo集合monthly_online_machines，核心字段如下：
  • zoneId：对应统计的时区ID
  • statYear：统计年份
  • statMonth：统计月份
  • onlineMachines：对应时段在线的机器详情列表
  • createTime：统计记录生成时间
• 给monthly_online_machines集合加唯一索引：(zoneId, statYear, statMonth)，避免重复存储相同维度的数据。

2.2 多时区月度时间范围计算 #

使用Java 8+ 带时区的时间API计算指定时区上月的起止UTC毫秒级时间戳，示例代码：

// 入参为管理员对应的标准时区ID
public static Pair<Long, Long> getLastMonthUtcRange(ZoneId zoneId) {
    // 取当前时区的当前时间
    ZonedDateTime nowInZone = ZonedDateTime.now(zoneId);
    // 计算上月的起始时间：上月1号 00:00:00.000
    ZonedDateTime lastMonthStart = nowInZone.minusMonths(1)
            .withDayOfMonth(1)
            .toLocalDate()
            .atStartOfDay(zoneId);
    // 计算上月的结束时间：上月最后一天 23:59:59.999
    ZonedDateTime lastMonthEnd = lastMonthStart.plusMonths(1)
            .minusNanos(1);
    // 转成UTC时间戳返回
    return Pair.of(lastMonthStart.toInstant().toEpochMilli(), 
                   lastMonthEnd.toInstant().toEpochMilli());
}

2.3 数据查询与去重计算 #

执行逻辑按以下顺序，避免重复查询原集合浪费性能：

1. 先查询所有管理员的时区ID，做去重处理，同一时区只计算一次
2. 对每个去重后的时区ID，先查monthly_online_machines集合是否存在对应年月的统计记录
3. 若已存在记录，直接取出复用；若不存在，执行Mongo查询：

// 入参为计算得到的上月起止UTC时间戳
public List<MachineStatus> queryOnlineMachines(Long startUtcMs, Long endUtcMs) {
    Query query = new Query();
    query.addCriteria(Criteria.where("status").is("ONLINE")
            .and("updateTime").gte(startUtcMs).lte(endUtcMs));
    return mongoTemplate.find(query, MachineStatus.class);
}

4. 将查询得到的结果存入monthly_online_machines集合，方便后续复用

2.4 分群推送 #

按管理员所属时区分组，将对应时区的上月在线机器列表推送给同组的所有管理员即可。 #

3. 异常与幂等处理 #

• 调度任务增加重试机制，配合monthly_online_machines的唯一索引，重试时不会重复生成统计记录
• 推送逻辑增加幂等校验，同一管理员同一月份的通知不会重复发送

内容的提问来源于stack exchange，提问作者Jithin M V