已投产Java+PostgreSQL项目集成Flyway的可行性及配置咨询

首先明确结论：完全可以在已上线的现有项目中直接集成Flyway，只要按照标准流程配置，不会对现有库表结构和业务数据产生影响。

具体需要完成的特殊配置和操作步骤如下：

一、前置基线准备 #

• 导出当前生产环境的全量数据库结构SQL：包含所有数据表、索引、视图、函数、触发器、序列、权限配置等所有数据库对象的创建语句，仅导出结构，不要包含业务数据。
• 按照Flyway命名规范重命名导出的SQL文件，推荐命名为V1__Production_Baseline.sql，注意版本号和描述之间用双下划线分隔。
• 将该SQL文件放到项目中Flyway默认扫描的迁移目录下（默认是src/main/resources/db/migration）。

二、核心特殊配置 #

根据你项目的集成方式调整对应配置：

• 如果是Spring Boot项目，在application.yml/application.properties中添加配置：

  # 非空库自动执行基线操作，不会因为库中已有表报错
  spring.flyway.baseline-on-migrate: true
  # 基线版本号，和前面的基线SQL版本号保持一致
  spring.flyway.baseline-version: 1
  # 适配PostgreSQL的字符编码
  spring.flyway.encoding: UTF-8
  

• 如果是独立使用Flyway的普通Java项目，在flyway.conf中添加配置：

  flyway.baselineOnMigrate=true
  flyway.baselineVersion=1
  flyway.encoding=UTF-8
  

注意：基线版本号必须和你创建的基线SQL文件的版本号完全匹配，Flyway会将该版本标记为已执行状态，不会重复运行基线SQL中的建表语句。

三、验证上线流程 #

1. 先在测试环境还原和生产结构完全一致的测试库，启动集成Flyway的项目，验证两点：一是自动生成flyway_schema_history元数据表，表中存在版本号为1的基线记录；二是现有库表结构和业务数据完全正常，没有被修改。
2. 新增一条测试变更SQL，比如命名为V2__Add_user_phone_index.sql，写入添加索引的语句，重启项目验证Flyway会自动执行该变更，且变更记录写入元数据表。
3. 生产环境上线前再次确认生产库结构和基线SQL完全一致，直接上线集成Flyway的项目即可。

注意事项 #

• 已经执行过的迁移文件绝对不能修改内容，否则Flyway会触发校验失败报错
• 如果后续需要调整已经执行的SQL，需要新增高版本的变更文件实现修改
• 不要手动修改flyway_schema_history元数据表的内容，避免Flyway状态混乱

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