IntelliJ中执行flywayMigrate任务无法读取环境变量的问题

核心原因：IDE中Gradle任务的环境变量传递逻辑和命令行不同 #

你遇到的问题本质是IntelliJ中Gradle任务的环境变量来源和命令行执行存在差异，具体拆解为以下几个常见问题：

1. Gradle Daemon缓存了旧环境变量 #

当你之前在未加载dev.env的状态下运行过Gradle任务，Gradle会启动一个后台Daemon进程，这个进程会缓存当时的环境变量。即使你后来重新加载环境变量启动IntelliJ，已运行的Daemon不会自动更新环境，导致新任务仍用旧值。

• 解决：
  • 在IntelliJ右侧Gradle工具窗口，找到右上角的"Restart Gradle Daemon"按钮（循环箭头图标）点击重启。
  • 或者打开终端执行./gradlew --stop手动停止Daemon，再回到IDE重新运行任务。

2. IntelliJ的Gradle运行配置未继承系统环境变量 #

默认情况下，IntelliJ的Gradle任务运行配置可能没有勾选"继承系统环境变量"，导致IDE的环境变量无法传递给Gradle构建进程。

• 解决：
  1. 点击IntelliJ顶部菜单栏的Run > Edit Configurations。
  2. 在弹出窗口中找到flywayMigrate任务（如果没有，点击"+"添加Gradle任务）。
  3. 切换到"Environment variables"标签页，勾选"Include system environment variables"选项。
  4. 若仍有问题，可手动添加JDBC_DATABASE_URL变量，填入对应的值。

3. Flyway配置文件的变量替换时机问题 #

你在Flyway配置文件中用${JDBC_DATABASE_URL}的方式，依赖的是Flyway自身的变量替换机制，而这个机制在Gradle构建初期解析配置时，可能还没拿到传递过来的环境变量。而你的TestEnv类是在应用运行时读取环境变量，时机更晚，所以能正常获取。

• 解决：
  在build.gradle中直接通过代码读取环境变量，替代配置文件的变量引用：

  flyway {
      url = System.getenv("JDBC_DATABASE_URL") ?: "jdbc:default:connection" // 可加默认值避免报错
      locations = ["filesystem:db/migrations"]
  }
  

  这种方式直接从JVM进程的环境变量中读取，可靠性更高。

4. GUI应用的环境变量传递限制（部分系统） #

在macOS等系统中，通过终端启动GUI应用（比如idea命令）时，部分环境变量可能无法被GUI进程完全继承（因为GUI应用的环境变量来源和终端不同）。

• 解决：
  1. 打开IntelliJ的File > Settings > Build, Execution, Deployment > Build Tools > Gradle。
  2. 在"Gradle JVM"下方的"Environment variables"区域，点击"+"按钮添加JDBC_DATABASE_URL和对应的值，直接给Gradle构建进程指定环境变量。

内容的提问来源于stack exchange，提问作者Kranthi U