使用jooq-codegen-gradle插件遇DDLDatabase类NotFound问题求助

常见原因及修复步骤 #

1. 确认依赖配置的正确性 #

DDLDatabase属于jooq-meta-extensions模块，必须确保该依赖被正确添加到代码生成任务的类路径中。在build.gradle.kts里，要将其配置到jooqCodegen专属的依赖块，而非全局依赖：

jooq {
    configurations {
        create("main") {
            jooqConfiguration.apply {
                generator.apply {
                    database.apply {
                        name = "org.jooq.meta.extensions.ddl.DDLDatabase"
                        // 其他数据库配置（如Flyway脚本路径、方言）
                    }
                }
            }
        }
    }
}

dependencies {
    jooqCodegen("org.jooq:jooq-meta-extensions:${jooqVersion}")
    jooqCodegen("org.jooq:jooq-codegen:${jooqVersion}")
}

注意：JOOQ 3.19+版本中DDLDatabase的包路径未发生变化，不要写错类的全限定名。

2. 检查Gradle依赖解析结果 #

执行以下命令查看代码生成任务的依赖树，确认jooq-meta-extensions是否存在：

./gradlew dependencies --configuration jooqCodegen

如果未找到该依赖，检查repositories块是否配置了MavenCentral：

repositories {
    mavenCentral()
}

3. 排除版本冲突 #

若项目中存在多版本JOOQ依赖，可能导致类加载异常。可强制统一所有JOOQ相关组件的版本：

configurations.all {
    resolutionStrategy.force(
        "org.jooq:jooq:${jooqVersion}",
        "org.jooq:jooq-meta:${jooqVersion}",
        "org.jooq:jooq-meta-extensions:${jooqVersion}",
        "org.jooq:jooq-codegen:${jooqVersion}"
    )
}

4. 清理Gradle缓存 #

缓存损坏也可能引发类找不到的问题，执行以下命令清理缓存后重新构建：

./gradlew clean build --refresh-dependencies

5. 核对DDLDatabase配置细节 #

检查数据库配置中的类名、包路径是否拼写正确，同时确保Flyway脚本路径等参数配置无误：

database.apply {
    name = "org.jooq.meta.extensions.ddl.DDLDatabase"
    properties.apply {
        property("scripts", "src/main/resources/db/migration")
        property("sqlDialect", "POSTGRES") // 替换为你的数据库方言
    }
}

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