Liquibase中CustomTaskRollback回滚方法重复执行问题解析

问题背景

在Liquibase数据库变更管理工具中，开发者可以通过实现CustomTaskRollback接口来自定义回滚逻辑。然而在4.26.0版本中存在一个关键缺陷：当执行自定义回滚操作时，rollback方法会被意外地执行两次。

技术原理

这个问题的根源在于Liquibase核心引擎的处理逻辑。在CustomChangeWrapper类中，回滚操作会先后触发两个不同的执行路径：

1. 首先在执行addSqlMdc方法时触发一次回滚
2. 随后在executeStatements方法中再次触发回滚

这与正常的变更执行流程形成了对比，因为在变更执行逻辑中已经修复了类似的重复执行问题，但回滚路径却没有同步修正。

影响范围

该问题会影响所有使用以下特性的项目：

• 实现了CustomTaskRollback接口的自定义变更
• 使用了rollback逻辑的数据库迁移脚本
• Liquibase 4.26.0及之前版本

解决方案

在Liquibase 4.30.0版本中，开发团队已经修复了这个问题。升级到该版本或更高版本即可解决回滚方法重复执行的问题。

最佳实践建议

1. 对于生产环境，建议尽快升级到4.30.0或更高版本
2. 在自定义回滚逻辑中，可以考虑添加幂等性处理，增强代码健壮性
3. 实现CustomTaskRollback时，应当记录详细的执行日志，便于问题排查

技术深度解析

这个问题实际上反映了框架设计中执行流控制的重要性。在Liquibase的执行引擎中，变更和回滚虽然是相反的操作，但共享了部分基础架构。开发者需要特别注意这类对称操作在框架实现中的一致性。

该修复确保了Liquibase执行引擎在处理自定义回滚时与处理自定义变更保持相同的行为模式，消除了特殊场景下的不一致性，提高了框架的可靠性。