Gradle任务中结合Testcontainers时JOOQ无法生成模型问题排查

问题背景 #

使用Gradle任务通过PostgreSQL Testcontainers生成JOOQ模型，流程为启动容器→Flyway执行迁移→调用JOOQ GenerationTool。运行./gradlew jooqGenerate时，Flyway迁移正常，但JOOQ仅输出警告，src/main/java目录无代码生成。相关代码如下：

buildscript {
  repositories {
    mavenLocal()
    mavenCentral()
  }
  dependencies {
    classpath("org.jooq:jooq-codegen:3.17.4")
    classpath("org.postgresql:postgresql:42.5.0")
    classpath("org.testcontainers:postgresql:1.17.3")
    classpath("org.flywaydb:flyway-core:9.3.0")
  }
}

task("jooqGenerate") {
  doLast {
    PostgreSQLContainer<Nothing>("postgres:14.3")
      .apply { start() }
      .use { pgContainer ->
        val flyway = Flyway(
          FluentConfiguration()
            .locations("filesystem:src/main/resources/db/migration")
            .baselineOnMigrate(true)
            .dataSource(pgContainer.jdbcUrl, pgContainer.username, pgContainer.password)
        )
        flyway.migrate()

        GenerationTool.generate(
          Configuration()
            .withJdbc(
              Jdbc()
                .withDriver(pgContainer.driverClassName)
                .withUrl(pgContainer.jdbcUrl)
                .withUser(pgContainer.username)
                .withPassword(pgContainer.password)
            )
            .withGenerator(
              Generator()
                .withDatabase(Database().withInputSchema("public"))
                .withGenerate(Generate().withPojosAsKotlinDataClasses(true))
                .withTarget(
                  Target()
                    .withPackageName("co.selim.nemrut.jooq")
                    .withDirectory("src/main/java")
                )
            )
        )
      }
  }
}

核心问题及修复步骤 #

1. 缺失JOOQ核心依赖 #

buildscript中仅引入了jooq-codegen，但JOOQ代码生成需要jooq核心库支持。在buildscript.dependencies中添加：

classpath("org.jooq:jooq:3.17.4")

2. 未指定PostgreSQL数据库类型 #

JOOQ无法自动识别数据库类型，需显式指定PostgreSQL的数据库元数据类：

.withDatabase(Database()
  .withInputSchema("public")
  .withName("org.jooq.meta.postgres.PostgresDatabase") // 新增该配置
)

3. 验证Flyway迁移是否实际创建表 #

Flyway提示迁移成功不代表表已创建，可在flyway.migrate()后添加验证代码，确认数据库中存在表：

// 执行后会打印数据库中的表列表
pgContainer.execInContainer("psql", "-U", pgContainer.username, "-d", pgContainer.databaseName, "-c", "\\dt")

4. 补充JOOQ生成项配置 #

当前仅开启Kotlin数据类生成，若需要完整的JOOQ模型（表类、记录类等），需添加更多生成开关：

.withGenerate(Generate()
  .withPojosAsKotlinDataClasses(true)
  .withTables(true) // 生成表定义类
  .withRecords(true) // 生成记录类
  .withDaos(true) // 可选：生成DAO类
)

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