ShedLock项目中手动调用定时任务的方法与锁机制解析

背景介绍

在分布式系统中，定时任务的并发控制是一个常见需求。ShedLock作为轻量级分布式锁工具，常被用于防止Spring定时任务在多个实例上重复执行。但在实际开发中，我们可能遇到需要同时支持手动触发和自动调度的业务场景。

核心问题分析

开发者经常存在这样的疑问：当使用ShedLock保护的方法既被Spring调度器调用又被手动调用时，锁机制是否仍然有效？这涉及到ShedLock的实现原理：

1. PROXY_METHOD模式：通过Spring AOP实现方法拦截，无论方法是被调度器触发还是直接调用，都会经过代理逻辑
2. 无框架模式：通过LockingTaskExecutor显式控制锁范围

技术实现细节

代理模式下的锁机制

当使用@SchedulerLock注解时，ShedLock会创建AOP代理。这意味着：

• 方法调用无论来自何处（调度器/手动调用）都会经过锁检查
• 锁的获取和释放由AOP切面统一管理
• 需要确保调用经过Spring代理（注意自调用问题）

显式锁控制模式

对于需要动态控制的任务：

• DefaultLockingTaskExecutor是线程安全的，适合作为单例
• 典型用法示例：

// 初始化（可配置为Bean）
LockProvider lockProvider = ...;
LockingTaskExecutor executor = new DefaultLockingTaskExecutor(lockProvider);

// 执行任务
executor.executeWithLock(() -> {
    // 业务逻辑
}, new LockConfiguration("lockName", Duration.ofSeconds(30)));

最佳实践建议

1. 混合调用场景：推荐使用PROXY_METHOD模式，保持代码简洁
2. 动态任务：采用显式锁控制，配合任务队列使用
3. 锁配置：注意设置合理的lockAtMostFor时间
4. 异常处理：确保任务异常时锁能正常释放

常见误区

1. 认为ShedLock仅适用于Spring调度任务（实际支持任意方法）
2. 忽略自调用导致的代理失效问题
3. 混淆PROXY_METHOD和TASK_SCHEDULER模式的应用场景

通过正确理解这些机制，开发者可以灵活地在各种场景下应用ShedLock的分布式锁功能。