Docker+PostgreSQL+Spring环境下Flyway迁移表结构不符求助

我在Docker容器中使用PostgreSQL镜像，搭配Spring框架部署数据库。通过Flyway创建V1版本迁移脚本后，发现实际表结构与脚本不一致：TEXT类型被转为varchar，还出现了未指定的约束；后续修改脚本新增country列，刷新Flyway历史后，表中并未新增该列。

Flyway V1初始迁移脚本 #

CREATE TABLE customer(
    id BIGSERIAL PRIMARY KEY,
    name TEXT NOT NULL,
    email TEXT NOT NULL,
    age INT NOT NULL
)

Customer实体类代码 #

@Entity
@Data
public class Customer {

    @Id
    @GeneratedValue(
            strategy = GenerationType.SEQUENCE,
            generator = "customer_id_sequence"
    )
    @SequenceGenerator(
            name = "customer_id_sequence",
            sequenceName = "customer_id_sequence")
    private Integer id;

    @Column(nullable = false, name = "name")
    private String name;

    @Column(nullable = false, name = "email")
    private String email;

    @Column(nullable = false, name = "age")
    private Integer age;
}

修改后的Flyway迁移脚本（新增country列） #

CREATE TABLE customer(
    id BIGSERIAL PRIMARY KEY,
    name TEXT NOT NULL,
    email TEXT NOT NULL,
    age INT NOT NULL,
    country TEXT NOT NULL 
)

Docker Compose配置 #

services:
  db:
    container_name: postgres
    image: postgres
    environment:
      POSTGRES_USER: smite
      POSTGRES_PASSWORD: 110011
      PGDATA: /data/postgres
    volumes:
      - db:/data/postgres
    ports:
      - "5332:5432"
    networks:
      - db
    restart: unless-stopped

networks:
  db:
    driver: bridge

volumes:
  db:

问题原因 #

1. Flyway迁移逻辑限制：Flyway会将已执行的脚本记录到flyway_schema_history表，直接修改已执行过的V1脚本不会触发重新执行，新增列自然不会生效。
2. Hibernate自动DDL干扰：Spring Boot默认可能开启spring.jpa.hibernate.ddl-auto（如create/update），Hibernate会根据实体类自动生成或修改表结构——实体类中String默认映射PostgreSQL的varchar，这就是TEXT类型被替换的原因，额外约束也来自Hibernate的自动生成。
3. 类型不匹配：迁移脚本中id是BIGSERIAL（对应Java的Long），但实体类里是Integer，类型不一致会导致潜在结构冲突。

解决方案 #

1. 规范Flyway迁移流程：

   • 不要修改已执行的脚本，新建迁移脚本（如V2__add_country_column_to_customer.sql），用ALTER语句添加列：

     ALTER TABLE customer ADD COLUMN country TEXT NOT NULL;
     

   • 若必须重新执行V1脚本，需手动删除flyway_schema_history中V1的记录，同时删除customer表，再重启应用触发Flyway重新执行（生产环境谨慎操作）。

2. 关闭Hibernate自动DDL：
   在配置文件中添加：

   spring.jpa.hibernate.ddl-auto=none
   

   让Flyway完全接管数据库结构管理，避免Hibernate干扰。

3. 统一类型映射：
   将实体类中的id类型改为Long，与迁移脚本的BIGSERIAL匹配：

   private Long id;
   

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