Liquibase中PostgreSQL生成列的defaultValueComputed问题解析

问题背景

在数据库迁移工具Liquibase中，当使用PostgreSQL数据库时，开发人员发现了一个关于生成列(GENERATED COLUMN)的特殊问题。具体表现为：在addColumn操作中使用defaultValueComputed属性定义生成列时，生成的SQL语句会出现语法错误，而同样的定义在createTable操作中却能正常工作。

问题现象

当开发人员尝试通过以下变更集添加生成列时：

<addColumn schemaName="public" tableName="test">
    <column defaultValueComputed="GENERATED ALWAYS AS (value->>'foo') STORED"
            name="foo"
            type="TEXT"/>
</addColumn>

Liquibase会生成错误的SQL语句：

ALTER TABLE public.test ADD foo TEXT DEFAULT GENERATED ALWAYS AS (value->>'foo') STORED

这个SQL语句会导致PostgreSQL报错："ERROR: syntax error at or near 'ALWAYS'"，因为PostgreSQL不允许在生成列定义前添加DEFAULT关键字。

技术分析

生成列与默认值的区别

在PostgreSQL中，生成列(GENERATED COLUMN)和带有默认值的列(DEFAULT)是两种不同的概念：

1. 生成列：其值总是由其他列计算得出，不能直接插入或更新
2. 默认值列：仅在插入时未提供值时使用默认值，之后可以独立更新

PostgreSQL要求生成列必须使用GENERATED ALWAYS AS语法，而不能与DEFAULT关键字混用。

Liquibase的内部处理

通过分析Liquibase源代码发现，AddColumnGenerator在处理defaultValueComputed属性时，会默认在所有情况下添加DEFAULT关键字。对于Oracle数据库，代码中已经做了特殊处理，当检测到GENERATED ALWAYS开头的表达式时会跳过DEFAULT关键字。但对于PostgreSQL，缺少类似的特殊处理逻辑。

解决方案

该问题的修复方案是在PostgreSQL数据库的处理逻辑中也加入类似的检查，当defaultValueComputed的值以"GENERATED ALWAYS"开头时，不添加DEFAULT关键字。

此外，还发现了一个相关的问题：Liquibase对defaultValueComputed值的空白字符处理不够健壮。当值中包含前导空白时，即使内容正确，也可能导致检查失败。因此，在比较前应该先对字符串进行trim()操作。

最佳实践

在使用Liquibase定义PostgreSQL生成列时，建议：

1. 确保defaultValueComputed的值以"GENERATED ALWAYS AS"开头，没有前导空白
2. 对于复杂的生成表达式，可以适当换行但不要在最前面添加空白
3. 在升级Liquibase版本后，验证生成列相关的迁移脚本

总结

这个问题展示了数据库迁移工具在处理不同数据库特有语法时面临的挑战。通过理解PostgreSQL生成列的特殊语法要求，以及Liquibase内部的处理机制，开发人员可以更好地编写兼容的数据库迁移脚本。同时，这也提醒我们在使用高级数据库特性时，需要关注工具对这些特性的支持程度。