JOOQ同包下POJO与DAO代码生成失败，求助单次编译方案

问题 #

我的POJO（JPA实体）与DAO在同一包下，已通过jooq-codegen-maven配置从JPA实体生成TableImpl代码，但DAO代码依赖TableImpl，出现循环依赖导致的编译异常：

• 首次执行mvn clean install时，jOOQ代码生成器获取到0张表，DAO因TableImpl未生成报“未知类”编译错误，同包JPA实体的编译流程被跳过；
• 注释DAO代码后编译，jOOQ仍获取0张表，但包内其他代码（含9个JPA实体）编译成功；
• 再次编译时，jOOQ能获取9张表并生成对应TableImpl；
• 取消DAO注释后再次编译，所有代码可成功编译，但多次编译并非可行方案。

切换为QueryDSL（使用apt-maven-plugin）可实现一次编译成功，推测是因为QueryDSL通过APT在编译前生成Q类，而jOOQ的JPADatabase需要依赖已编译的JPA实体类，从而形成循环依赖。

我的pom.xml中相关插件配置如下：

<plugin>
    <groupId>com.mysema.maven</groupId>
    <artifactId>apt-maven-plugin</artifactId>
    <version>1.1.3</version>
    <executions>
        <execution>
            <goals>
                <goal>process</goal>
            </goals>
            <configuration>
                <outputDirectory>target/generated-sources/java</outputDirectory>
                <processor>com.querydsl.apt.jpa.JPAAnnotationProcessor</processor>
            </configuration>
        </execution>
    </executions>
</plugin>

<plugin>
    <groupId>org.jooq</groupId>
    <artifactId>jooq-codegen-maven</artifactId>
    <version>${jooq.version}</version>

    <executions>
        <execution>
            <id>jooq-codegen</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>generate</goal>
            </goals>
        </execution>
    </executions>

    <configuration>
        <generator>
            <database>
                <name>org.jooq.meta.extensions.jpa.JPADatabase</name>
                <inputSchema>PUBLIC</inputSchema>
                <outputSchemaToDefault>true</outputSchemaToDefault>
                
                <properties> 
                    <property>
                        <key>packages</key>
                        <value>com.mypack.business</value>
                    </property>

                    <property>
                        <key>useAttributeConverters</key>
                        <value>true</value>
                    </property> 
                    <property>
                        <key>unqualifiedSchema</key>
                        <value>none</value>
                    </property>
                </properties>
            </database>
            <target>
                <packageName>com.mypack.business.repository.entity.jooq</packageName>
                <directory>target/generated-sources/java</directory>
            </target>
        </generator>
    </configuration>
</plugin>

请问如何实现jOOQ的单次编译成功？若难度较大，拆分POJO与DAO（含jOOQ代码生成）到两个项目是否可行？

解决方案 #

方法一：调整编译流程，先编译实体再生成jOOQ代码 #

jOOQ的JPADatabase需要读取已编译的JPA实体字节码，默认的generate-sources阶段在编译前执行，此时实体类尚未编译，因此无法识别。可以通过拆分编译步骤解决：

1. 先编译JPA实体类，排除DAO代码
2. 执行jOOQ代码生成
3. 编译所有代码（包括DAO和生成的TableImpl）

完整配置示例：

<!-- 分两次编译：先编译实体，再编译全部代码 -->
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.1</version>
    <executions>
        <!-- 第一步：仅编译JPA实体，排除DAO -->
        <execution>
            <id>compile-entities</id>
            <phase>compile</phase>
            <goals>
                <goal>compile</goal>
            </goals>
            <configuration>
                <excludes>
                    <exclude>**/repository/**/*.java</exclude>
                </excludes>
            </configuration>
        </execution>
        <!-- 第二步：编译所有代码，包含DAO和jOOQ生成类 -->
        <execution>
            <id>compile-all</id>
            <phase>process-classes</phase>
            <goals>
                <goal>compile</goal>
            </goals>
            <configuration>
                <includes>
                    <include>**/*.java</include>
                </includes>
                <sourcePaths>
                    <sourcePath>${project.build.directory}/generated-sources/java</sourcePath>
                </sourcePaths>
            </configuration>
        </execution>
    </executions>
</plugin>

<!-- 将jOOQ生成的源码目录加入Maven源码路径 -->
<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>build-helper-maven-plugin</artifactId>
    <version>3.2.0</version>
    <executions>
        <execution>
            <id>add-source</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>add-source</goal>
            </goals>
            <configuration>
                <sources>
                    <source>${project.build.directory}/generated-sources/java</source>
                </sources>
            </configuration>
        </execution>
    </executions>
</plugin>

<!-- 调整jOOQ代码生成到实体编译完成后 -->
<plugin>
    <groupId>org.jooq</groupId>
    <artifactId>jooq-codegen-maven</artifactId>
    <version>${jooq.version}</version>
    <executions>
        <execution>
            <id>jooq-codegen</id>
            <phase>compile</phase>
            <goals>
                <goal>generate</goal>
            </goals>
        </execution>
    </executions>
    <!-- 原有database、target配置保持不变 -->
</plugin>

方法二：拆分模块（推荐） #

拆分POJO与DAO到两个独立Maven项目完全可行，也是解决循环依赖最彻底的方案：

1. 实体模块：仅包含JPA实体类，不依赖DAO或jOOQ生成代码，可单独编译；
2. DAO模块：依赖实体模块，配置jOOQ从实体模块的编译产物生成TableImpl，同时编写DAO代码依赖生成类。

这种方式的优势：

• 彻底消除循环依赖，编译流程清晰；
• 实体模块可被其他模块复用（如JPA查询、DTO转换）；
• jOOQ代码生成直接依赖实体模块的编译产物，无需额外调整编译阶段。

为什么QueryDSL可以一次编译成功？ #

QueryDSL使用APT（注解处理工具），在Java编译过程中，APT会先扫描注解生成Q类，生成的Q类自动加入编译流程，无需等待实体类编译完成。而jOOQ的JPADatabase是读取已编译的字节码生成代码，必须在实体类编译完成后执行，这是两者核心差异。

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