Spring Boot 3中Flyway迁移提示“未找到迁移文件”的解决求助

一、修复Flyway找不到迁移文件的问题 #

1. 确认迁移文件目录结构 #

检查资源目录结构是否为**src/main/resources/db/migration**（层级目录，而非命名为db.migration的单目录）。在IntelliJ中需依次创建db目录，再在其下创建migration子目录，不能直接创建名称带点的目录。

2. 验证Flyway配置与依赖 #

• 在application.properties中显式指定迁移文件位置，避免默认配置失效：

  spring.flyway.locations=classpath:db/migration
  

• 确保项目已引入正确的Flyway依赖：
  Maven（pom.xml）：

  <dependency>
      <groupId>org.flywaydb</groupId>
      <artifactId>flyway-core</artifactId>
  </dependency>
  <dependency>
      <groupId>org.flywaydb</groupId>
      <artifactId>flyway-mysql</artifactId>
  </dependency>
  

  Gradle（build.gradle）：

  implementation 'org.flywaydb:flyway-core'
  implementation 'org.flywaydb:flyway-mysql'
  

3. 检查迁移文件命名规范 #

Flyway要求文件名严格遵循V<版本号>__<描述>.sql格式（注意是两个下划线分隔版本与描述），你的V1__create-table-doctor.sql命名符合规范，但需确认无拼写错误、大小写问题（部分系统对文件名大小写敏感）。

4. 确认数据库连接与权限 #

• 用DB Browser插件连接vollmed_api数据库，执行CREATE TABLE test(id INT);验证连接与权限正常；
• 若admin用户权限不足，可通过MySQL控制台执行授权命令：

  GRANT ALL PRIVILEGES ON vollmed_api.* TO 'admin'@'localhost';
  FLUSH PRIVILEGES;
  

5. 重置Flyway历史记录 #

若数据库中存在异常的flyway_schema_history表，手动删除该表后重启应用，Flyway会重新扫描并执行所有迁移文件。

二、使用Flyway创建与修改表的标准流程 #

1. 创建初始表（V1版本） #

在db/migration下创建V1__create-table-doctor.sql，内容如下（你的原文件无误）：

create table doctors(
id bigint not null auto_increment,
name varchar(100) not null,
email varchar(100) not null unique,
crm varchar(6) not null unique,
specialty varchar(100) not null,
street varchar(100) not null,
neighborhood varchar(100) not null,
zipcode varchar(9) not null,
complement varchar(100),
number varchar(20),
state char(2) not null,
city varchar(100) not null,
primary key(id)
);

2. 修改表（V2及后续版本） #

如需修改表结构（例如添加手机号字段），创建V2__alter-table-doctor-add-phone.sql，内容：

ALTER TABLE doctors ADD COLUMN phone VARCHAR(20) NULL;

注意版本号需递增，描述清晰，严格遵循命名格式。

3. 自动执行迁移 #

启动Spring Boot应用，Flyway会自动检测未执行的迁移文件，执行SQL并更新flyway_schema_history表记录迁移状态。

三、解决IntelliJ终端无法运行MySQL的问题 #

1. 配置环境变量 #

将MySQL安装目录下的bin文件夹（例如Windows下C:\Program Files\MySQL\MySQL Server 8.0\bin，Linux/macOS下/usr/local/mysql/bin）添加到系统PATH环境变量，配置后重启IntelliJ即可在终端直接调用mysql命令。

2. 使用IntelliJ内置MySQL控制台 #

打开IntelliJ的Database工具窗口，选中你的MySQL连接，右键选择Open Console，即可打开内置控制台执行SQL命令，操作更便捷。

3. 终端直接连接MySQL #

环境变量配置完成后，在IntelliJ终端执行：

mysql -u admin -p

输入密码12345即可进入MySQL命令行。

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