迁移至官方jOOQ Gradle插件时遇ClassNotFoundException问题

问题根源 #

官方jOOQ Gradle插件的jooqCodegen任务拥有独立的类路径，不会自动复用应用依赖中的JDBC驱动。而nu.studer插件默认会将驱动纳入代码生成的类路径，这就是回退旧插件能正常运行的原因。

修复步骤 #

1. 为代码生成任务单独配置驱动依赖 #

在build.gradle中，把JDBC驱动依赖添加到jooqCodegen配置下，而非仅放在应用依赖块里。示例配置如下：

plugins {
    id 'java'
    id 'org.jooq.jooq-codegen-gradle' version '3.19.0'
}

repositories {
    mavenCentral()
}

dependencies {
    // 应用自身的驱动依赖（可选保留，不影响代码生成）
    runtimeOnly 'org.mariadb.jdbc:mariadb-java-client:3.3.3'
    
    // 必须给代码生成任务单独添加驱动
    jooqCodegen 'org.mariadb.jdbc:mariadb-java-client:3.3.3'
}

jooq {
    configurations {
        main {
            generationTool {
                database {
                    name = 'org.jooq.meta.mariadb.MariaDBDatabase'
                    url = 'jdbc:mariadb://localhost:3306/your_database'
                    user = 'db_user'
                    password = 'db_password'
                    driver = 'org.mariadb.jdbc.Driver'
                }
                generator {
                    target {
                        packageName = 'com.yourcompany.jooq'
                        directory = 'src/main/java'
                    }
                }
            }
        }
    }
}

注意：驱动版本请根据实际使用情况调整，确保和应用依赖的版本一致。

2. 验证配置是否生效 #

执行以下命令查看jooqCodegen任务的类路径，确认驱动jar已包含在内：

./gradlew jooqCodegen --info | grep -A 20 "classpath"

3. 避开常见坑点 #

• 不要仅将驱动添加到implementation或runtimeOnly，这些依赖属于应用模块，与代码生成任务的类路径完全隔离。
• 确保jOOQ插件版本与jOOQ核心库版本统一（此处均为3.19.0），版本不匹配可能引发类加载异常。

为什么换PostgreSQL也报错？ #

这不是bug，是官方插件的设计逻辑——无论使用哪种数据库驱动，都需要显式将其加入代码生成任务的类路径，和nu.studer插件的默认行为不同而已。

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