Spring Boot集成Liquibase生成Geometry空间类型时输出TINYBLOB问题求解

1. 补充Liquibase MySQL扩展依赖 #

默认Liquibase核心包对MySQL空间类型的适配不全，需要在Maven的pom.xml中引入liquibase-mysql扩展，版本要和你使用的Liquibase核心版本保持一致，避免兼容性问题：

<dependency>
    <groupId>org.liquibase.ext</groupId>
    <artifactId>liquibase-mysql</artifactId>
    <version>4.3.0</version>
</dependency>

2. 修正Liquibase Maven插件的方言配置 #

你只在Spring Boot配置中指定了Hibernate空间方言，但Liquibase执行diff生成changelog、或者执行update时不会自动读取Spring的配置，需要在Liquibase插件的配置中主动添加方言参数：

<plugin>
    <groupId>org.liquibase</groupId>
    <artifactId>liquibase-maven-plugin</artifactId>
    <version>4.3.0</version>
    <configuration>
        <!-- 保留你的其他原有配置 -->
        <property>
            <name>hibernate.dialect</name>
            <value>org.hibernate.spatial.dialect.mysql.MySQL8SpatialDialect</value>
        </property>
        <property>
            <name>url</name>
            <value>jdbc:mysql://你的数据库地址/库名?useSSL=false&serverTimezone=Asia/Shanghai&useUnicode=true&characterEncoding=utf8</value>
        </property>
    </configuration>
</plugin>

3. 修正JPA实体类注解 #

给Point字段添加明确的列定义和类型注解，避免Hibernate默认映射为二进制类型：

import org.locationtech.jts.geom.Point;
import javax.persistence.Column;
import javax.persistence.Entity;
import org.hibernate.annotations.Type;

@Entity
class MyModel {

    @Type(type = "org.hibernate.spatial.GeometryType")
    @Column(columnDefinition = "POINT", nullable = false)
    private Point location;

    // 其他字段
}

4. 手动编写changelog时使用原生SQL兜底 #

如果还是出现类型映射错误，直接在changeSet中使用原生SQL标签创建表/字段，跳过Liquibase的类型自动转换，100%避免类型转换异常：

<changeSet id="add_location_column" author="你的配置名">
    <sql>
        ALTER TABLE my_model ADD COLUMN location POINT NOT NULL;
    </sql>
</changeSet>

验证步骤 #

执行mvn liquibase:update前先清理之前生成的错误changelog，同时检查数据库中对应表是否已经存在错误的TINYBLOB类型字段，如果存在先手动删除或者新增独立的changeSet修改字段类型。

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