Liquibase创建PostgreSQL表字段类型不符问题及解决咨询

我编写了如下Liquibase变更日志：

<databaseChangeLog
    xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
         http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-3.1.xsd">

    <changeSet id="01" author="me">
        <createTable tableName="folders" remarks="Folders">
            <column name="id" type="uuid">
                <constraints nullable="false" unique="true" primaryKey="true"/>
            </column>
            <column name="name" type="varchar(255)">
                <constraints nullable="false"/>
            </column>
            <column name="last_edited" type="datetime">
                <constraints nullable="false"/>
            </column>
            <column name="folder_type" type="varchar(10)">
                <constraints nullable="false"/>
            </column>
        </createTable>
    </changeSet>

</databaseChangeLog>

创建PostgreSQL表后发现：

• id字段实际类型为varchar(255)，而非指定的uuid
• folder_type字段实际类型为int4，而非指定的varchar(10)

请问原因是什么？如何创建指定类型的字段？

原因分析 #

1. 旧版本Liquibase类型映射缺陷：你使用的是Liquibase 3.1.x版本的schema，该版本对PostgreSQL原生类型的支持不完善。通用类型uuid会被错误映射为varchar(255)，varchar(10)也可能因解析逻辑bug被误判为数值类型。
2. 通用类型与方言适配问题：Liquibase的通用数据类型（如datetime、uuid）依赖数据库方言做映射，旧版本方言对PostgreSQL的类型转换规则存在偏差。

解决方法 #

1. 直接使用PostgreSQL原生数据类型 #

在变更日志中显式指定PostgreSQL原生类型，绕过通用类型的映射逻辑：

<databaseChangeLog
    xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
         http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-3.1.xsd">

    <changeSet id="01" author="me">
        <createTable tableName="folders" remarks="Folders">
            <!-- 直接使用PostgreSQL原生uuid类型 -->
            <column name="id" type="uuid">
                <constraints nullable="false" unique="true" primaryKey="true"/>
            </column>
            <column name="name" type="varchar(255)">
                <constraints nullable="false"/>
            </column>
            <!-- PostgreSQL中用timestamp替代datetime -->
            <column name="last_edited" type="timestamp">
                <constraints nullable="false"/>
            </column>
            <column name="folder_type" type="varchar(10)">
                <constraints nullable="false"/>
            </column>
        </createTable>
    </changeSet>

</databaseChangeLog>

2. 升级Liquibase版本 #

Liquibase 4.x及以上版本对PostgreSQL的类型映射做了大幅优化，通用类型uuid会正确映射为PostgreSQL的uuid类型，varchar类型也不会被错误解析。建议升级到最新稳定版，并对应更新schema文件的版本（如使用dbchangelog-4.x.xsd）。

3. 确认方言配置正确 #

在Liquibase配置中明确指定PostgreSQL方言，避免类型解析错误：

# 配置文件中的方言设置示例
liquibase.databaseClass=liquibase.database.core.PostgresDatabase

内容的提问来源于stack exchange，提问作者Lev83