Jooq + Flyway 代码生成失败：配置无效及H2数据库错误排查

1. 「jOOQ代码生成工具配置错误」原因分析 #

直接执行mvn jooq-codegen:generate时，Maven只会读取插件根节点下的<configuration>配置，不会加载<executions>标签内的自定义配置。把代码生成配置放在<executions>里，仅适用于绑定到Maven生命周期阶段（比如generate-sources）自动执行的场景，手动调用goal时会因找不到有效配置报错。

2. 配置移至executions外后H2错误的排查方向 #

2.1 版本兼容性冲突 #

Spring Boot 3.2.3基于Jakarta EE规范，而jOOQ 3.16.12仍依赖旧的Java EE（javax.*）API，两者核心依赖不兼容，会触发类加载失败、类型不支持等问题。解决方法：将jOOQ版本升级至3.19.0及以上（3.19版本开始全面支持Jakarta EE）。

2.2 H2数据库路径不一致 #

Flyway生成的H2文件路径必须和jOOQ配置的JDBC URL完全匹配，否则会出现数据库文件找不到的错误。

• Flyway配置示例：

  <configuration>
    <url>jdbc:h2:./target/h2/testdb;DB_CLOSE_DELAY=-1</url>
    <user>sa</user>
    <password></password>
  </configuration>
  

• jOOQ配置需同步使用相同URL：

  <configuration>
    <jdbc>
      <driver>org.h2.Driver</driver>
      <url>jdbc:h2:./target/h2/testdb;DB_CLOSE_DELAY=-1</url>
      <user>sa</user>
      <password></password>
    </jdbc>
    <!-- 其他代码生成配置 -->
  </configuration>
  

2.3 H2版本依赖冲突 #

通过mvn dependency:tree检查依赖树，确保Flyway、jOOQ和Spring Boot使用的H2版本一致。Spring Boot 3.2.3默认绑定H2 2.2.224，若其他依赖引入了不同版本，需通过<dependencyManagement>统一版本。

2.4 旧版jOOQ对H2新类型的支持不足 #

jOOQ 3.16.x版本未适配H2 2.x的部分新数据类型，升级jOOQ到兼容版本后，类型不支持问题会自动解决。

3. 完整配置示例 #

<!-- Flyway插件配置，绑定到generate-sources阶段自动执行迁移 -->
<plugin>
  <groupId>org.flywaydb</groupId>
  <artifactId>flyway-maven-plugin</artifactId>
  <version>10.10.0</version>
  <configuration>
    <url>jdbc:h2:./target/h2/testdb;DB_CLOSE_DELAY=-1</url>
    <user>sa</user>
    <password></password>
    <locations>
      <location>classpath:db/migration</location>
    </locations>
  </configuration>
  <executions>
    <execution>
      <phase>generate-sources</phase>
      <goals>
        <goal>migrate</goal>
      </goals>
    </execution>
  </executions>
</plugin>

<!-- jOOQ代码生成插件，升级到兼容Spring Boot 3.x的版本 -->
<plugin>
  <groupId>org.jooq</groupId>
  <artifactId>jooq-codegen-maven</artifactId>
  <version>3.19.10</version>
  <configuration>
    <jdbc>
      <driver>org.h2.Driver</driver>
      <url>jdbc:h2:./target/h2/testdb;DB_CLOSE_DELAY=-1</url>
      <user>sa</user>
      <password></password>
    </jdbc>
    <generator>
      <database>
        <name>org.jooq.meta.h2.H2Database</name>
        <inputSchema>PUBLIC</inputSchema>
      </database>
      <generate>
        <pojos>true</pojos>
        <daos>true</daos>
      </generate>
      <target>
        <packageName>com.example.jooq.generated</packageName>
        <directory>src/main/java</directory>
      </target>
    </generator>
  </configuration>
  <executions>
    <execution>
      <phase>generate-sources</phase>
      <goals>
        <goal>generate</goal>
      </goals>
    </execution>
  </executions>
  <dependencies>
    <dependency>
      <groupId>com.h2database</groupId>
      <artifactId>h2</artifactId>
      <version>${h2.version}</version>
    </dependency>
  </dependencies>
</plugin>

配置完成后，执行mvn generate-sources即可自动完成Flyway迁移和jOOQ代码生成，无需手动调用单独的goal。

内容的提问来源于stack exchange，提问作者Adam G