Spring Schedule + ShedLock + RabbitMQ 生产级落地方案 - 云楼（中国）

Oo_行者_oO2026-06-14 9:52

(基于 Spring Cloud Alibaba 微服务体系)

1. 概述

本方案将 定时调度 、分布式锁 与 消息队列 有机结合，构建一个轻量、可靠、可扩展的分布式定时任务调度服务。 核心思路：

  • 使用 @Scheduled 定义触发时机
  • 使用 ShedLock 保证集群中同一时刻只有一个实例触发调度
  • 触发后仅向 RabbitMQ 发送一条指令消息，极轻量
  • 真正的业务逻辑由消息消费者在其他服务中异步执行，实现解耦、削峰、重试

适用场景：固定 Cron 表达式的周期性任务（如订单超时取消、报表生成、数据同步），且希望避免引入重型调度中心。

2. 环境依赖

2.1 已集成组件（基于 pom.xml）

  • Spring Cloud Alibaba
    • Nacos：服务发现与配置中心
    • Sentinel：流量控制、熔断降级，规则持久化至 Nacos
  • 消息队列
    • RabbitMQ (spring-boot-starter-amqp)
    • RocketMQ (rocketmq-spring-boot-starter) ------ 本方案以 RabbitMQ 为主
  • 分布式锁
    • ShedLock 核心 + Redis 提供者（推荐，解锁方式简单）
    • 备选：JDBC 提供者（需建表）
  • 公共模块
    • common-security、common-apidoc、schedule-api 等

2.2 建议启用的额外依赖

bash 复制代码 
<!-- 启用 Redis 锁提供者（取消注释并确保版本） -->
<dependency>
    <groupId>net.javacrumbs.shedlock</groupId>
    <artifactId>shedlock-provider-redis-spring</artifactId>
    <version>5.10.2</version> <!-- 与 shedlock-spring 版本一致 -->
</dependency>

若选择 JDBC 锁，则无需额外引入（已含 shedlock-provider-jdbc-template），但需配置数据源。

3. 整体架构与交互流程

bash 复制代码 
 ┌─────────────┐       ┌─────────────┐       ┌─────────────┐
 │ 实例1        │       │ 实例2        │       │ 实例N        │
 │ @Scheduled  │       │ @Scheduled  │       │ @Scheduled  │
 │ + ShedLock  │       │ + ShedLock  │       │ + ShedLock  │
 └──────┬──────┘       └──────┬──────┘       └──────┬──────┘
        │     锁竞争（Redis）   │                    │
        └──────────────────────┼────────────────────┘
                               │ 胜出者发送消息
                               ▼
                     ┌─────────────────┐
                     │   RabbitMQ      │
                     │ 交换机/队列     │
                     └────────┬────────┘
                              │ 消费
                              ▼
                     ┌─────────────────┐
                     │  业务消费者服务  │
                     │ (独立微服务)     │
                     │ 真正执行任务     │
                     └─────────────────┘
  • 调度服务 （schedule-service）：仅负责触发消息，轻量快速，锁持有时间 < 1s
  • RabbitMQ：提供可靠异步投递、消息持久化、重试、死信
  • 业务消费者：监听指定队列，执行批量处理，支持手动确认、幂等

4. 项目模块划分

模块 说明
schedule-api 对外暴露的 API（如任务手动触发接口、状态查询）
schedule-service 本模块，包含调度配置、消息发送、ShedLock 配置
业务消费者 在其他微服务中实现，使用 @RabbitListener

5. 配置管理 (Nacos)

5.1 公共配置 schedule-service.yaml (存放于 Nacos)

bash 复制代码 
spring:
  rabbitmq:
    host: ${RABBITMQ_HOST:10.0.0.10}
    port: 5672
    username: admin
    password: ${RABBITMQ_PASSWORD}
    publisher-confirm-type: correlated   # 发送端确认
    publisher-returns: true
    listener:
      simple:
        concurrency: 2
        max-concurrency: 8
        prefetch: 1
        acknowledge-mode: manual         # 手动确认
        retry:
          enabled: true
          max-attempts: 3
          initial-interval: 1000ms
          multiplier: 2.0
  redis:
    host: ${REDIS_HOST:10.0.0.20}
    port: 6379
    password: ${REDIS_PASSWORD}
    database: 0
    timeout: 3000ms
    lettuce:
      pool:
        max-active: 8
        max-idle: 4

scheduling:
  pool-size: 10           # 定时任务线程池大小
  tasks:
    order-cancel:
      enabled: true       # 动态开关

5.2 服务本地 bootstrap.yml

bash 复制代码 
spring:
  cloud:
    nacos:
      discovery:
        server-addr: ${NACOS_SERVER:127.0.0.1:8848}
      config:
        server-addr: ${NACOS_SERVER:127.0.0.1:8848}
        file-extension: yaml
        shared-configs:
          - data-id: schedule-service.yaml
            group: DEFAULT_GROUP
            refresh: true
  application:
    name: schedule-service

6. 核心实现

6.1 ShedLock 配置（Redis 方式）

bash 复制代码 
@Configuration
@EnableScheduling
@EnableSchedulerLock(defaultLockAtMostFor = "PT1M")  // 全局默认锁最大持有1分钟
public class SchedulerConfig {

    @Bean
    public LockProvider lockProvider(RedisConnectionFactory connectionFactory) {
        return new RedisLockProvider(connectionFactory, "schedule-service");
    }
}

锁参数说明：

  • lockAtMostFor：锁的强制释放时间，必须大于任务最长执行时间（此处发送消息几乎瞬间，30s足够）
  • lockAtLeastFor：锁最短持有时间，防止同一任务因时钟漂移瞬间重复执行（建议5~15s）

JDBC 备选（如需使用）：

bash 复制代码 
@Bean
public LockProvider lockProvider(DataSource dataSource) {
    return new JdbcTemplateLockProvider(
        JdbcTemplateLockProvider.Configuration.builder()
            .withJdbcTemplate(new JdbcTemplate(dataSource))
            .usingDbTime()
            .build()
    );
}

并执行建表 SQL（见运维手册）。

6.2 调度线程池配置

避免默认单线程导致任务阻塞。

bash 复制代码 
@Configuration
public class SchedulingThreadPoolConfig implements SchedulingConfigurer {

    @Value("${scheduling.pool-size:10}")
    private int poolSize;

    @Override
    public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
        taskRegistrar.setScheduler(taskExecutor());
    }

    @Bean(destroyMethod = "shutdown")
    public ScheduledExecutorService taskExecutor() {
        return Executors.newScheduledThreadPool(poolSize,
                new ThreadFactoryBuilder().setNameFormat("sched-pool-%d").build());
    }
}

6.3 RabbitMQ 配置

6.3.1 声明交换机、队列、绑定

bash 复制代码 
@Configuration
public class RabbitMQDeclareConfig {

    public static final String TASK_EXCHANGE = "scheduled.task.exchange";
    public static final String TASK_QUEUE = "scheduled.task.queue";
    public static final String TASK_ROUTING_KEY = "task.execute";

    // 死信
    public static final String DLX_EXCHANGE = "scheduled.task.dlx.exchange";
    public static final String DLX_QUEUE = "scheduled.task.dlx.queue";
    public static final String DLX_ROUTING_KEY = "task.execute.dlx";

    @Bean
    public DirectExchange taskExchange() {
        return new DirectExchange(TASK_EXCHANGE, true, false);
    }

    @Bean
    public Queue taskQueue() {
        return QueueBuilder.durable(TASK_QUEUE)
                .deadLetterExchange(DLX_EXCHANGE)
                .deadLetterRoutingKey(DLX_ROUTING_KEY)
                .build();
    }

    @Bean
    public Binding taskBinding() {
        return BindingBuilder.bind(taskQueue()).to(taskExchange()).with(TASK_ROUTING_KEY);
    }

    @Bean
    public DirectExchange dlxExchange() {
        return new DirectExchange(DLX_EXCHANGE);
    }

    @Bean
    public Queue dlxQueue() {
        return new Queue(DLX_QUEUE);
    }

    @Bean
    public Binding dlxBinding() {
        return BindingBuilder.bind(dlxQueue()).to(dlxExchange()).with(DLX_ROUTING_KEY);
    }
}

6.3.2 消息序列化（JSON）

bash 复制代码 
@Configuration
public class RabbitMQMessageConfig {

    @Bean
    public MessageConverter messageConverter() {
        return new Jackson2JsonMessageConverter();
    }
}

6.4 定时任务触发器（发送消息）

任务指令对象：

bash 复制代码 
@Data
@AllArgsConstructor
@NoArgsConstructor
public class TaskCommand implements Serializable {
    private String taskType;          // 任务类型标识，如 "ORDER_CANCEL"
    private String traceId;           // 链路追踪ID
    private Map<String, Object> params; // 可选参数
}

触发器示例：

bash 复制代码 
@Component
@Slf4j
@ConditionalOnProperty(name = "scheduling.tasks.order-cancel.enabled", havingValue = "true")
public class OrderCancelTrigger {

    private final RabbitTemplate rabbitTemplate;

    public OrderCancelTrigger(RabbitTemplate rabbitTemplate) {
        this.rabbitTemplate = rabbitTemplate;
    }

    @Scheduled(cron = "${scheduling.tasks.order-cancel.cron:0 0/5 * * * ?}")
    @SchedulerLock(name = "OrderCancelTask",
            lockAtMostFor = "PT30S",
            lockAtLeastFor = "PT10S")
    public void triggerOrderCancel() {
        String traceId = MDC.get("traceId");
        TaskCommand cmd = new TaskCommand("ORDER_CANCEL", traceId, null);
        rabbitTemplate.convertAndSend(
                RabbitMQDeclareConfig.TASK_EXCHANGE,
                RabbitMQDeclareConfig.TASK_ROUTING_KEY,
                cmd,
                message -> {
                    message.getMessageProperties().setMessageId(UUID.randomUUID().toString());
                    return message;
                }
        );
        log.info("Sent task command: {}", cmd.getTaskType());
    }
}

要点：

  • @ConditionalOnProperty 实现 Nacos 动态开关，无需重启
  • Cron 表达式也支持外部化配置，可在 Nacos 中修改后通过 @RefreshScope 刷新（需在类上加 @RefreshScope）
  • 锁保护确保单实例发送

6.5 业务消费者（在其他微服务中实现，此处示例）

bash 复制代码 
@Component
@Slf4j
public class OrderCancelConsumer {

    @Autowired
    private OrderService orderService;

    @RabbitListener(queues = RabbitMQDeclareConfig.TASK_QUEUE)
    public void handleTask(TaskCommand command, Channel channel,
                           @Header(AmqpHeaders.DELIVERY_TAG) long tag) {
        try {
            if ("ORDER_CANCEL".equals(command.getTaskType())) {
                orderService.cancelExpiredOrders();
            }
            channel.basicAck(tag, false);
        } catch (Exception e) {
            log.error("Task execution failed: {}", command, e);
            // 根据异常类型决定是否重新入队
            try {
                channel.basicNack(tag, false, true); // 重试
            } catch (IOException io) {
                // 记录错误，触发告警
            }
        }
    }
}

注意：业务服务必须实现幂等（如基于状态机 + 乐观锁）。

7. Sentinel 流控与降级

7.1 保护发送消息的接口

虽然触发器是内部调用，我们仍可使用 Sentinel 对 RabbitTemplate 的发送进行包装，避免突发流量冲垮 RabbitMQ。

自定义 Sentinel 资源：

bash 复制代码 
@Scheduled(...)
@SchedulerLock(...)
public void triggerOrderCancel() {
    Entry entry = null;
    try {
        entry = SphU.entry("send_task_command");
        // 发送消息
    } catch (BlockException e) {
        log.warn("Flow control triggered, task command send blocked");
    } finally {
        if (entry != null) entry.exit();
    }
}

更优雅的方式是对 RabbitTemplate.convertAndSend 使用 Sentinel 的 @SentinelResource 或定义切面。

7.2 Sentinel 规则持久化至 Nacos

bash 复制代码 
# sentinel-degrade-rules
[
  {
    "resource": "send_task_command",
    "count": 20,
    "grade": 1,
    "timeWindow": 10
  }
]

当每秒发送超过 20 条时熔断 10 秒，防止 RabbitMQ 过载。

8. 动态任务开关与配置刷新

利用 Spring Cloud Alibaba 的配置刷新能力，关键任务可通过 Nacos 实时启停，无需重新部署。

  • 在触发器上使用 @ConditionalOnProperty
  • 在配置类上添加 @RefreshScope
  • 在 Nacos 中修改 scheduling.tasks.xxx.enabled 即可

也可将 Cron 表达式外置：

bash 复制代码 
@Scheduled(cron = "${order.cancel.cron}")

并在 Nacos 中更新，配合 @RefreshScope 会重新初始化任务调度（需要 ScheduledTaskRegistrar 重新注册，稍复杂，推荐使用 XXL-JOB 等动态平台）。

9. 监控与告警

9.1 指标采集 (Micrometer)

bash 复制代码 
@Bean
public MeterRegistryCustomizer<MeterRegistry> metricsCommonTags() {
    return registry -> registry.config().commonTags("application", "schedule-service");
}

// 定时任务执行埋点（AOP）
@Around("@annotation(scheduled)")
public Object monitorSchedule(ProceedingJoinPoint pjp, Scheduled scheduled) {
    Timer.Sample sample = Timer.start(meterRegistry);
    try {
        Object result = pjp.proceed();
        sample.stop(Timer.builder("scheduled.task.execution")
                .tag("task", pjp.getSignature().getName())
                .tag("status", "success")
                .register(meterRegistry));
        return result;
    } catch (Exception e) {
        sample.stop(Timer.builder("scheduled.task.execution")
                .tag("task", pjp.getSignature().getName())
                .tag("status", "error")
                .register(meterRegistry));
        throw e;
    }
}

9.2 告警策略

  • 当 scheduled.task.execution 的 status=error 计数 > 0，触发钉钉/邮件通知
  • RabbitMQ 死信队列 scheduled.task.dlx.queue 有消息堆积，立即告警
  • 任务执行耗时超过阈值（如 30s）告警

9.3 分布式链路追踪

在 TaskCommand 中传递 traceId，使用 SkyWalking 或 Sleuth + Zipkin，串联调度服务和消费服务。

10. 优雅关闭与高可用

10.1 优雅关闭配置

bash 复制代码 
server:
  shutdown: graceful
spring:
  lifecycle:
    timeout-per-shutdown-phase: 30s

此设置让正在发送的消息有足够时间完成 RabbitMQ 交互，并等待 @RabbitListener 中正在处理的消息完成（消费者端）。

10.2 RabbitMQ 高可用

  • 生产环境使用 RabbitMQ 集群 + 镜像队列，保证队列数据不丢失
  • 消息设置 deliveryMode=2 持久化
  • publisher-confirm 开启，发送端确保消息投递

10.3 调度服务高可用

  • 多实例部署（≥2），通过 ShedLock 竞争，自动故障转移
  • Redis 哨兵/集群保证锁存储可用

11. 运维手册

11.1 ShedLock 表创建（如果使用 JDBC 方式）

bash 复制代码 
CREATE TABLE shedlock (
    name       VARCHAR(64)  NOT NULL,
    lock_until TIMESTAMP    NOT NULL,
    locked_at  TIMESTAMP    NOT NULL,
    locked_by  VARCHAR(255) NOT NULL,
    PRIMARY KEY (name)
);

11.2 日常巡检

  • Redis 锁监控 ：KEYS schedule-service* 可查看当前持有的锁
  • RabbitMQ 控制台 ：检查队列 scheduled.task.queue 的消息堆积、消费者数量
  • 死信队列 ：scheduled.task.dlx.queue 消息数应为 0，若存在则说明有消费失败的消息，需排查

11.3 常见问题

问题 可能原因 解决方法
任务重复执行 ShedLock 未生效（配置错误、Redis连接失败） 检查 @EnableSchedulerLock、LockProvider Bean 是否正常，检查日志
消息堆积 消费者处理太慢或宕机 增加消费者实例数，检查消费者逻辑是否有死循环
定时任务不触发 开关关闭、Cron 表达式错误、线程池满 检查 Nacos 配置、@ConditionalOnProperty，查看线程堆栈
锁超时释放导致重复发消息 lockAtMostFor 设置太小，发送消息超时 调大锁时长，优化 RabbitMQ 连接超时配置

12. 附录：完整代码示例

12.1 调度服务主类

bash 复制代码 
@SpringBootApplication
@EnableDiscoveryClient
@RefreshScope
public class ScheduleServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(ScheduleServiceApplication.class, args);
    }
}

12.2 自定义健康检查（可选）

bash 复制代码 
@Component
public class ShedLockHealthIndicator implements HealthIndicator {
    @Autowired
    private LockProvider lockProvider;
    @Override
    public Health health() {
        // 简单检查锁提供者是否可用
        Optional<SimpleLock> lock = lockProvider.lock(new LockConfiguration("health-check", Instant.now(), "health"));
        if (lock.isPresent()) {
            lock.get().unlock();
            return Health.up().build();
        }
        return Health.down().withDetail("shedlock", "LockProvider unavailable").build();
    }
}

12.3 全局异常处理

bash 复制代码 
@RestControllerAdvice
public class GlobalExceptionHandler {
    // 针对定时任务触发的 HTTP 接口（如手动触发）
}

13. 总结

这份方案将 Spring Schedule + ShedLock + RabbitMQ 无缝融入现有的 Spring Cloud Alibaba 体系，充分利用 Nacos 动态配置、Sentinel 流控以及 RabbitMQ 的可靠投递能力，构建了一个 高可用、可观测、易运维 的分布式定时任务调度服务。

它足够轻量，却能稳稳支撑核心业务场景。当未来需求增长至需要动态 Cron、任务分片时，可平滑迁移至 XXL-JOB 或 PowerJob，当前消息驱动架构为此类演进提供了天然基础。

相关推荐
Hical611 小时前
百万 TCP 长连接内存实测：50 万点回归，R²=1.0000，每连接 7.58 KB
后端·github
AI人工智能+电脑小能手1 小时前
【大白话说Java面试题 第113题】【并发篇】第13题：说一下乐观锁的优点和缺点？
java·开发语言·面试
Mahir081 小时前
HashMap 底层原理深度解密：从数据结构到 JDK1.7/1.8 演进全解
java·后端·面试·hashmap
uhakadotcom1 小时前
get_event_loop()，和 get_running_loop() + ThreadPoolExecutor 有啥区别
后端·面试·github
小马爱打代码2 小时前
Spring Boot 自动装配流程
java·spring boot·后端
Cosolar2 小时前
72小时生死时速：一文读懂引爆Fable模型禁令的越狱技术风暴
人工智能·后端·程序员
我登哥MVP2 小时前
SpringCloud 核心组件解析：分布式配置管理
java·spring boot·分布式·spring·spring cloud·java-ee·maven
lihao lihao2 小时前
linux线程
java·开发语言·jvm
满怀冰雪2 小时前
第13篇-栈算法入门-括号匹配-表达式与单调栈基础
java·算法
热门推荐
01HTTP 与 HTTPS 的区别：从原理到实战详解022026 AI 编程工具终极实战指南：Cursor vs Claude Code vs Copilot，开发者该怎么选？03【AI】2026 年具身智能模型和世界模型总结042026年6月AI行业全景：从百模大战到Agent元年，这30天发生了什么？05AI科技热点日报 | 2026年6月1日06《置身钉内》原文-可播放阅读07Claude Code、Codex、Cursor三分天下：2026年AI编程Agent生态全景剖析08GitHub 镜像站点092026 年 AI 编程工具终极横评：Cursor vs Claude Code vs Copilot vs Windsurf10AI一周事件 · 2026-06-03 至 2026-06-09