使用Liquibase+Spring Boot+Hibernate启动时PostgreSQL报表已存在错误

这个问题我之前也碰到过，核心原因就是数据库表的创建逻辑和数据插入逻辑的执行顺序乱了，或者是有重复创建表的行为在同时发生。咱们一步步拆解解决：

1. 先掐掉重复建表的源头：禁用Hibernate自动DDL #

既然你已经用Liquibase来管理数据库schema了，就别让Hibernate瞎掺和建表了。打开你的application.properties（或application.yml），把Hibernate的自动建表配置改成none：

# application.properties
spring.jpa.hibernate.ddl-auto=none

如果是YAML格式：

# application.yml
spring:
  jpa:
    hibernate:
      ddl-auto: none

之前你可能设置成了create、update之类的，Hibernate会在Liquibase执行前抢先创建表，导致Liquibase的建表变更集执行时发现表已经存在，直接报错。

2. 规范数据插入的方式：把data.sql移到Liquibase变更集里（推荐） #

Spring Boot默认会自动执行data.sql，但这个时机和Liquibase的执行顺序很容易冲突。更靠谱的做法是把插入数据的逻辑整合到Liquibase的变更集中，这样能严格保证先建表，再插数据的顺序：

• 在你的Liquibase changelog目录下（比如src/main/resources/db/changelog）创建一个新的变更集文件，比如002_insert_initial_data.xml
• 把data.sql里的插入语句放到这个变更集的<sql>标签里：

<?xml version="1.0" encoding="UTF-8"?>
<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-4.9.xsd">

    <changeSet id="2" author="your-name">
        <sql>
            -- 这里复制你data.sql里的所有插入语句
            INSERT INTO container (id, name) VALUES (1, 'test-container');
            -- 其他插入语句...
        </sql>
    </changeSet>
</databaseChangeLog>

• 然后在主changelog文件里引入这个新的变更集，保证它在建表的变更集之后：

<!-- 主changelog文件，比如db.changelog-master.xml -->
<include file="db/changelog/001_create_tables.xml" relativeToChangelogFile="true"/>
<include file="db/changelog/002_insert_initial_data.xml" relativeToChangelogFile="true"/>

这样Liquibase会按顺序先执行建表，再插入数据，完全不会有顺序问题。

3. 如果非要保留data.sql：调整执行顺序 #

如果你不想动data.sql，那就要强制让Spring Boot等Liquibase执行完再跑data.sql。在配置文件里加这些：

# application.properties
# 启用data.sql执行
spring.sql.init.mode=always
# 设置Liquibase先执行（顺序1）
spring.liquibase.order=1
# 设置data.sql后执行（顺序2）
spring.sql.init.order=2
# 指定数据库平台（可选，避免跨数据库语法问题）
spring.sql.init.platform=postgresql

这样就能保证Liquibase先建好表，data.sql再插入数据，不会出现表不存在或者重复创建的问题。

4. 清理残留的历史数据（如果需要） #

如果之前已经执行过错误的启动，导致数据库里已经有container表，或者Liquibase的databasechangelog表有异常记录，可以：

• 直接清空数据库，重新启动
• 用Liquibase命令回滚到初始状态：mvn liquibase:rollback -Dliquibase.rollbackCount=1（根据你的变更集数量调整）

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