JeecgBoot项目首次启动时Flyway执行SQL异常问题分析

问题现象

在JeecgBoot 3.7.2版本中，部分开发者首次启动项目时会遇到Flyway执行SQL脚本异常的问题。具体表现为系统启动过程中，Flyway尝试执行v3.7.21__jimureport_upgrade.sql脚本时抛出SQL异常，提示某些字段已存在。

问题根源

经过分析，该问题主要由以下原因导致：

1. 数据库初始化脚本与Flyway迁移脚本冲突：项目提供的jeecgboot-mysql-5.7.sql初始化脚本中已经包含了积木BI(JimuReport)相关的最新表结构变更，而Flyway迁移脚本中又包含了相同的变更内容。

2. 版本更新时序问题：在3.7.2版本发布后，项目加入了积木BI功能，相关SQL变更被同时添加到了数据库初始化脚本和Flyway迁移脚本中。

解决方案

针对此问题，开发者可以采取以下任一解决方案：

方案一：删除冲突的Flyway脚本

1. 定位到项目中的db/migration目录
2. 删除或重命名v3.7.21__jimureport_upgrade.sql文件
3. 重新启动项目

方案二：清理数据库中的Flyway记录

1. 删除flyway_schema_history表中关于v3.7.21__jimureport_upgrade.sql的记录
2. 确保数据库中相关表结构已正确创建
3. 重新启动项目

预防措施

为避免类似问题，建议开发团队：

1. 保持数据库初始化脚本与Flyway迁移脚本的同步更新
2. 在添加新功能时，明确区分哪些变更应放入初始化脚本，哪些应作为迁移脚本
3. 建立数据库变更的版本控制机制，确保脚本执行的幂等性

技术背景

Flyway是一款数据库迁移工具，它通过记录已执行的SQL脚本来管理数据库版本。当Flyway检测到有未执行的迁移脚本时，会自动按版本顺序执行这些脚本。但当脚本内容与现有数据库结构冲突时，就会抛出异常。

在JeecgBoot项目中，Flyway与数据库初始化脚本共同构成了数据库版本管理方案，两者需要协调配合才能确保系统正常启动。