Liquibase 命令工厂缓存失效问题分析与解决方案

问题背景

在Liquibase开源数据库变更管理工具中，CommandFactory类负责管理和创建命令定义(CommandDefinition)。为了提高性能，该类内部维护了一个命令定义的缓存机制，使用命令名称数组作为键来存储已创建的CommandDefinition对象。

问题现象

开发人员发现CommandFactory中的commandDefinitions缓存实际上无法正常工作。每次调用getCommandDefinition方法时，即使传入相同的命令名称，系统都会创建新的CommandDefinition实例，而不是从缓存中获取已存在的定义。

技术分析

缓存失效的根本原因

问题出在缓存键的设计上。CommandFactory使用String[]数组作为ConcurrentHashMap的键，而getCommandDefinition方法使用可变参数(varargs)接收命令名称。在Java中，每次调用可变参数方法时，即使参数相同，JVM都会创建一个新的数组实例。

由于ConcurrentHashMap的get()方法比较的是数组实例而非数组内容，导致每次查询缓存都返回null，进而触发新CommandDefinition的创建。这使得缓存完全失效，带来了三个主要问题：

1. 性能损耗：每次调用都要重新计算命令定义
2. 内存浪费：缓存中存储了大量重复条目
3. 潜在不一致：相同命令可能产生不同的定义实例

相关代码分析

原缓存实现的关键代码如下：

private final Map<String[], CommandDefinition> commandDefinitions = new ConcurrentHashMap<>();

public CommandDefinition getCommandDefinition(String... commandName) {
    CommandDefinition commandDefinition = commandDefinitions.get(commandName);
    if (commandDefinition == null) {
        // 创建新定义并放入缓存
        commandDefinition = new CommandDefinition(commandName);
        // ...执行各种初始化操作...
        commandDefinitions.put(commandName, commandDefinition);
    }
    return commandDefinition;
}

解决方案

核心解决思路

将缓存键从String[]改为使用能够正确比较内容的类型。有两种主要方案：

1. 使用List：List实现了正确的equals和hashCode方法
2. 使用自定义键对象：封装数组并提供正确的equals/hashCode实现

实际采用的方案

开发团队选择了第一种方案，将缓存键类型改为List。这是因为：

1. List天然支持内容比较
2. 不需要额外创建自定义类
3. Java集合框架已经优化了List的性能

修改后的核心代码变为：

private final Map<List<String>, CommandDefinition> commandDefinitions = new ConcurrentHashMap<>();

public CommandDefinition getCommandDefinition(String... commandName) {
    List<String> key = Arrays.asList(commandName);
    CommandDefinition commandDefinition = commandDefinitions.get(key);
    if (commandDefinition == null) {
        commandDefinition = new CommandDefinition(commandName);
        // ...初始化操作...
        commandDefinitions.put(key, commandDefinition);
    }
    return commandDefinition;
}

影响与收益

这一修复为Liquibase带来了显著的性能提升：

1. 减少重复计算：相同命令只需初始化一次
2. 降低内存占用：避免了重复缓存条目
3. 提高响应速度：高频命令直接从缓存获取
4. 保持一致性：相同命令返回相同定义实例

最佳实践启示

这个问题为开发者提供了几个有价值的经验：

1. 谨慎选择Map键类型：避免使用数组作为Map键
2. 理解可变参数本质：认识到varargs会创建新数组
3. 缓存键设计原则：确保键对象实现了正确的equals和hashCode
4. 性能优化验证：不能假设缓存一定有效，需要实际验证

通过这个案例，我们可以看到即使是经验丰富的开发团队，也可能在看似简单的缓存实现上遇到问题。关键在于持续优化和及时修复，这正是开源社区协作的优势所在。