使用Liquibase变更日志在Snowflake建表时遇DATABASECHANGELOGLOCK已存在错误

可能原因及对应解决方案 #

1. 数据库/模式上下文不匹配 #

• Snowflake的表归属是数据库+模式的组合，你看到表存在的上下文可能和Liquibase当前连接的上下文不一致。
• 执行Liquibase命令时明确指定模式：

  liquibase --schema-name=你的目标模式 update
  

  或在liquibase.properties中配置：

  schemaName: 你的目标模式
  

2. 权限不足导致Liquibase无法识别表 #

• 当前Liquibase使用的Snowflake用户没有DATABASECHANGELOGLOCK表的查看权限，导致Liquibase误判表不存在。
• 给用户赋予对应权限：

  GRANT SELECT ON TABLE DATABASECHANGELOGLOCK TO 你的Liquibase用户;
  

3. Liquibase元数据缓存异常 #

• Liquibase缓存了旧的元数据状态，未识别到已创建的表。
• 执行命令重置校验和并清理缓存：

  liquibase clearCheckSums
  

  同时删除本地可能存在的Liquibase缓存文件（如*.lock或changelog缓存）。

4. 现有表结构与Liquibase预期不匹配 #

• 已存在的DATABASECHANGELOGLOCK表结构和Liquibase默认生成的结构不一致，触发重建逻辑。
• 先查看现有表结构：

  DESCRIBE TABLE DATABASECHANGELOGLOCK;
  

  对比报错中的创建语句，手动调整表结构匹配；或确认无依赖后删除表，让Liquibase重新生成。

5. Snowflake标识符大小写问题 #

• 如果创建表时使用了双引号，表名会区分大小写，而Liquibase默认用大写标识符访问。
• 检查表名实际大小写：

  SHOW TABLES LIKE 'DATABASECHANGELOGLOCK';
  

  若表名是小写/混合大小写，在Liquibase配置中用双引号指定表名，或修改表名统一为大写。

内容的提问来源于stack exchange，提问作者Umar Mukthar Nasoordeen