QueryDsl 5与MapStruct搭配时资源生成异常问题求助

在Spring Boot 3和Java 17环境中，显式配置maven-compiler-plugin的annotationProcessorPaths会关闭Maven默认的注解处理器自动发现机制，加上QueryDSL 5的APT需要明确指定处理器类、适配Jakarta EE版本，这才导致了两者的生成冲突。以下是可行的修复方案：

核心修复步骤 #

1. 升级maven-compiler-plugin版本 #

旧版本（如3.8.1）对Java 17的注解处理器支持不完善，建议升级到适配Java 17的版本，比如3.11.0：

2. 完整配置注解处理器路径与参数 #

同时添加MapStruct和QueryDSL的Jakarta版注解处理器，并为QueryDSL指定专属的处理器类：

<dependencies>
    <!-- QueryDSL JPA（Jakarta版） -->
    <dependency>
        <groupId>com.querydsl</groupId>
        <artifactId>querydsl-jpa</artifactId>
        <version>5.0.0</version>
        <classifier>jakarta</classifier>
    </dependency>
    <!-- QueryDSL APT（Jakarta版，provided scope） -->
    <dependency>
        <groupId>com.querydsl</groupId>
        <artifactId>querydsl-apt</artifactId>
        <version>5.0.0</version>
        <classifier>jakarta</classifier>
        <scope>provided</scope>
    </dependency>
    <!-- MapStruct核心依赖 -->
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
        <version>${org.mapstruct.version}</version>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <!-- 匹配Java 17版本 -->
                <source>17</source>
                <target>17</target>
                <annotationProcessorPaths>
                    <!-- MapStruct注解处理器 -->
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>${org.mapstruct.version}</version>
                    </path>
                    <!-- QueryDSL Jakarta版注解处理器 -->
                    <path>
                        <groupId>com.querydsl</groupId>
                        <artifactId>querydsl-apt</artifactId>
                        <version>5.0.0</version>
                        <classifier>jakarta</classifier>
                    </path>
                </annotationProcessorPaths>
                <!-- 必须指定QueryDSL的处理器类才会触发Q类生成 -->
                <annotationProcessors>
                    <annotationProcessor>com.querydsl.apt.jpa.JPAAnnotationProcessor</annotationProcessor>
                </annotationProcessors>
            </configuration>
        </plugin>
    </plugins>
</build>

3. 验证生成结果 #

执行mvn clean compile命令，检查target/generated-sources/annotations目录：

• 应该包含QueryDSL生成的Qxxx实体类
• 同时包含MapStruct生成的xxxImpl实现类

常见坑点排查 #

• 遗漏Jakarta classifier：QueryDSL 5区分javax和Jakarta版本，Spring Boot 3必须使用带jakartaclassifier的依赖，否则处理器无法识别Jakarta注解（如@Entity）
• 未指定annotationProcessors：QueryDSL的APT不会自动触发，必须明确配置JPAAnnotationProcessor（Jakarta版）
• Java版本不匹配：确保source和target都设置为17，与Spring Boot 3的要求一致

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