ShedLock 多锁提供者支持在模块化单体架构中的应用

背景与问题分析

在现代分布式系统架构中，任务调度是一个常见需求。ShedLock作为一个轻量级的分布式锁库，能够确保定时任务在分布式环境中只执行一次。然而，在模块化单体架构(Modular Monolith)中，特别是采用垂直切片架构(Vertical-Slice Architecture)的项目里，现有的ShedLock实现存在一个明显的局限性。

模块化单体架构将系统按照业务边界划分为多个独立模块，每个模块包含自己的应用层、领域层和数据访问层。这种架构强调模块间的解耦，每个模块通常拥有独立的数据存储方案。而当前ShedLock的设计强制要求整个应用只能使用单一的LockProvider，这与模块化设计的理念产生了冲突。

技术痛点

ShedLock现有的@SchedulerLock注解实现存在以下技术限制：

1. 依赖全局唯一的LockProvider Bean，无法为不同模块配置独立的锁存储
2. 注解处理逻辑硬编码了单LockProvider的假设
3. 无法支持不同模块使用不同数据库schema或不同锁机制的需求

这种限制导致在模块化架构中，所有模块被迫共享同一个锁存储，破坏了模块的独立性，可能引发以下问题：

• 模块间锁表耦合，难以独立演进
• 无法针对特定模块选择最优的锁实现
• 数据库权限和隔离级别难以精细控制

解决方案设计

针对上述问题，社区提出了扩展@SchedulerLock注解的方案，使其支持指定特定的LockProvider。核心设计思路包括：

1. 在注解中增加lockProvider属性，用于指定使用的LockProvider Bean名称
2. 修改注解处理逻辑，根据指定名称从Spring上下文中获取对应的LockProvider
3. 使用获取到的LockProvider创建专用的LockManager执行锁定逻辑

这种设计保持了向后兼容性，同时为模块化架构提供了必要的灵活性。实现上可以采用两种方式：

1. 直接扩展原生@SchedulerLock注解
2. 创建新的@QualifiedSchedulerLock注解作为补充

实现细节

在参考实现中，新增的@QualifiedSchedulerLock注解定义如下：

@Target({METHOD, ANNOTATION_TYPE})
@Retention(RUNTIME)
public @interface QualifiedSchedulerLock {
  String lockProvider();  // 指定LockProvider Bean名称
  String name();         // 锁名称
  String lockAtMostFor() default "";  // 最大锁定时间
  String lockAtLeastFor() default ""; // 最小锁定时间
}

对应的切面处理逻辑核心部分如下：

@Around("@annotation(QualifiedSchedulerLock)")
public Object acquireQualifiedSchedulerLock(ProceedingJoinPoint scheduledMethod) {
    // 获取注解配置
    var lockParameters = signature.getMethod().getAnnotation(QualifiedSchedulerLock.class);
    
    // 根据名称获取指定的LockProvider
    var lockProvider = (LockProvider) applicationContext.getBean(lockParameters.lockProvider());
    
    // 创建锁管理器并执行
    var lockManager = createLockManager(lockProvider, configurationExtractor);
    lockManager.executeWithLock(running(scheduledMethod));
    
    return null;
}

架构价值

这一改进为模块化架构带来了显著价值：

1. 真正的模块独立性：每个模块可以完全控制自己的锁存储策略
2. 技术多样性支持：不同模块可以根据需求选择Jdbc、Redis、Mongo等不同锁实现
3. 数据隔离：模块可以使用独立的数据库schema存储锁信息
4. 演进自由：模块可以独立升级或替换锁实现而不影响其他模块

最佳实践建议

在实际应用中，建议考虑以下实践：

1. 为每个业务模块定义专用的LockProvider Bean
2. 使用模块前缀命名锁表，如"modulea_locks"、"moduleb_locks"
3. 对于需要强隔离的场景，为模块配置独立的数据源
4. 在模块的自动配置类中定义相关的锁基础设施

总结

ShedLock对多LockProvider的支持解决了模块化架构中的一个关键痛点，使分布式锁管理能够与模块化设计原则保持一致。这一改进不仅提升了架构的灵活性，也为系统的可维护性和可扩展性带来了显著提升。对于采用垂直切片架构或领域驱动设计的项目，这一特性将大大简化分布式任务调度的实现复杂度。