Liquibase对比数据库结构时自动为无默认值BIT列添加DEFAULT 0的问题咨询

这并不是Liquibase的bug，而是它处理MariaDB BIT类型列时的一个默认逻辑问题，咱们来一步步拆解原因和解决办法：

为什么会出现这个情况？ #

当你在MariaDB 10.2中执行alter table my_table add no_default bit null;时，该列的实际默认值是NULL（因为显式指定了null且未设置默认值）。但Liquibase在进行diff操作时，对BIT类型列有特殊的默认值推断逻辑——它会默认认为BIT列的默认值是0（即false），哪怕数据库中实际没有设置这个默认值。

这个问题的根源在于Liquibase对MariaDB元数据的读取和类型映射逻辑：早期版本的Liquibase在处理BIT类型时，没有正确识别可空BIT列的NULL默认值，而是沿用了非空BIT列的默认值规则（非空BIT列在MariaDB中默认是0）。

避免该情况的方法 #

这里有几种可行的解决方案，你可以根据自己的场景选择：

1. 手动修正生成的变更日志 #

Liquibase生成diff后，直接编辑生成的changelog文件，把ALTER TABLE my_table ADD no_default BIT DEFAULT 0 NULL;修改为你实际需要的语句：

ALTER TABLE my_table ADD no_default BIT NULL;

这种方法简单直接，适合临时处理单个表的情况。

2. 在Liquibase中显式定义NULL默认值 #

如果是通过Liquibase的XML/YAML changelog来管理表结构，显式给该列设置defaultValueNull="true"，比如XML格式：

<addColumn tableName="my_table">
    <column name="no_default" type="BIT" nullable="true" defaultValueNull="true"/>
</addColumn>

这样后续执行diff操作时，Liquibase会识别到该列的默认值是NULL，不会再生成多余的DEFAULT 0。

3. 升级Liquibase到最新版本 #

这个问题在Liquibase的较新版本中已经被修复。如果你使用的是旧版本（比如低于4.x的版本），尝试升级到最新稳定版，新版本优化了对MariaDB各种类型的元数据读取逻辑，能正确识别可空BIT列的NULL默认值。

4. 自定义diff规则（进阶） #

如果需要批量处理这类问题，可以通过Liquibase的扩展机制自定义diff逻辑，过滤掉BIT列的默认值差异。不过这种方法需要一定的开发成本，适合有复杂需求的场景。

内容的提问来源于stack exchange，提问作者Giacomo Voß