Liquibase Session Lock 支持指南

Liquibase Session Lock 支持指南

项目介绍

Liquibase Session Lock 是一个专为 Liquibase 设计的扩展，提供了session级别的锁服务，相较于传统的事务级锁定，它在数据库连接意外中断时能自动释放锁。这一特性有效避免了因Liquibase非正常退出而导致的锁表问题。通过执行liquibase releaseLocks命令可能无法在微服务生产环境中轻松解决问题。此扩展支持MySQL、MariaDB、PostgreSQL和Oracle数据库，并且理论上可以通过扩展SessionLockService来支持更多数据库。

项目快速启动

要立即开始使用 liquibase-sessionlock，首先需将其添加到你的项目依赖中。以下是如何在不同构建系统中加入这个库的方法：

Maven

<dependency>
    <groupId>com.github.blagerweij</groupId>
    <artifactId>liquibase-sessionlock</artifactId>
    <version>1.6.9</version>
</dependency>

Gradle (Groovy DSL)

implementation 'com.github.blagerweij:liquibase-sessionlock:1.6.9'

或如果你正在使用Kotlin DSL：

implementation("com.github.blagerweij:liquibase-sessionlock:1.6.9")

对于Liquibase 3.7.x及以上版本，尤其是独立运行或集成Dropwizard框架的场景，可能需要将com.github.blagerweij.sessionlock添加到Liquibase类路径扫描器的白名单中。这可通过系统属性liquibase.scan.packages或MANIFEST.MF文件中的Liquibase-Package条目完成。

应用案例和最佳实践

案例一：确保数据库迁移的并发安全性

在分布式环境下部署多个微服务，并都需要对数据库进行迁移时，每个服务在执行Liquibase变更集之前都会尝试获取一个session级别的锁。这样可以防止多个实例同时修改数据库结构，导致数据不一致或冲突。

最佳实践

• 在生产环境部署前，先在测试环境中验证Lock Service的功能。
• 确保所有执行Liquibase操作的账户具有必要的权限，例如在Oracle上授予EXECUTE权限给DBMS_LOCK。
• 配置好异常处理逻辑，以便在连接丢失后能够自动重试获取锁。

典型生态项目结合

虽然该项目本身是作为Liquibase的插件存在，没有直接与其他特定生态系统项目绑定，但是其在微服务架构和持续部署管道中的应用非常广泛。结合CI/CD工具（如Jenkins、GitLab CI/CD）和容器化平台（Docker+kubernetes），可以在每次部署前自动化执行Liquibase迁移脚本，利用liquibase-sessionlock确保迁移过程的线程安全。

使用这个扩展，你可以整合到Spring Boot应用中，通过配置文件指定Liquibase的相关信息，并在应用启动阶段自动处理数据库更新，确保每一次应用部署都能平滑地处理数据库结构变化。

请注意，具体实施时应参照你的应用环境和需求调整配置，以实现最佳的集成效果。