部署SpringBoot+jOOQ应用至WildFly时jOOQ类加载失败问题

核心问题 #

你遇到的java.lang.NoSuchMethodError和Tables类未加载问题，本质是jOOQ版本不匹配：编译/代码生成用的是3.19.8，但运行时WAR包中实际是3.18.13，导致生成的jOOQ代码（比如Tables类）依赖的3.19.8版本方法在低版本库中不存在，同时类加载器无法找到适配的类。

可能的原因 #

• 依赖传递冲突：项目中某个间接依赖引入了3.18.13版本的jOOQ，覆盖了你配置的3.19.8
• WildFly容器内置依赖：WildFly 32自带旧版本jOOQ，部署时优先加载容器提供的库，而非WAR包内的版本
• Maven配置疏漏：父pom的版本管理未生效，或者data模块（生成jOOQ代码）的codegen版本与运行时依赖版本不一致

解决步骤 #

1. 定位依赖冲突来源 #

在项目根目录执行Maven命令，排查依赖树中低版本jOOQ的引入路径：

mvn dependency:tree -Dverbose -Dincludes=org.jooq:jooq

找到引入3.18.13的依赖后，在对应的pom.xml中排除该低版本依赖，示例：

<dependency>
    <groupId>第三方依赖groupId</groupId>
    <artifactId>第三方依赖artifactId</artifactId>
    <version>版本号</version>
    <exclusions>
        <exclusion>
            <groupId>org.jooq</groupId>
            <artifactId>jooq</artifactId>
        </exclusion>
    </exclusions>
</dependency>

2. 隔离容器内置jOOQ依赖 #

WildFly可能自带jOOQ模块，需在workflow-engine-example/src/main/webapp/WEB-INF下创建jboss-deployment-structure.xml，强制使用WAR包内的jOOQ版本：

<jboss-deployment-structure>
    <deployment>
        <exclusions>
            <module name="org.jooq" />
        </exclusions>
    </deployment>
</jboss-deployment-structure>

3. 统一jOOQ版本配置 #

• 确保父pom.xml的dependencyManagement中统一管理jOOQ所有相关依赖的版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.jooq</groupId>
            <artifactId>jooq</artifactId>
            <version>3.19.8</version>
        </dependency>
        <dependency>
            <groupId>org.jooq</groupId>
            <artifactId>jooq-codegen</artifactId>
            <version>3.19.8</version>
        </dependency>
        <dependency>
            <groupId>org.jooq</groupId>
            <artifactId>jooq-meta</artifactId>
            <version>3.19.8</version>
        </dependency>
    </dependencies>
</dependencyManagement>

• 确认workflow-engine-data模块的jooq-codegen版本与运行时依赖版本完全一致，因为jOOQ生成的代码和运行时库强绑定，版本差会直接导致方法缺失。

4. 验证打包结果 #

重新构建example模块，检查WAR包内的依赖版本：

mvn clean package -pl workflow-engine-example -am

解压WAR包后，查看WEB-INF/lib目录下的jooq-*.jar，确认所有jOOQ相关jar版本都是3.19.8。

5. 排查类加载问题 #

若版本统一后仍出现Tables类未加载：

• 检查workflow-engine-data模块是否被正确打包到example的WAR中，确认WEB-INF/lib存在data模块的jar包，或WEB-INF/classes包含生成的jOOQ类
• 核对net.internalerror.jooq.Tables的包路径是否与WAR包内的类文件路径一致，排除类路径配置错误

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