Java 9+IDEA+Spring Boot环境下QueryDSL的@Generated注解失效问题

我来帮你梳理下这个问题的解决思路，结合你提到的Java 9、Spring Boot和QueryDSL的场景，几个关键点可以逐一排查：

1. 确认QueryDSL版本与Gradle注解处理器配置 #

首先要确保你使用的QueryDSL版本是兼容Java 9的（建议4.2.0及以上），同时Gradle里的注解处理器配置要正确——即使类路径已经有javax.annotation-api，也要明确把它加入注解处理器路径，避免编译时找不到依赖：

dependencies {
    // QueryDSL核心JPA依赖
    implementation 'com.querydsl:querydsl-jpa:4.4.0'
    // JPA对应的APT注解处理器
    annotationProcessor 'com.querydsl:querydsl-apt:4.4.0:jpa'
    // 明确将注解API纳入处理器路径
    annotationProcessor 'javax.annotation:javax.annotation-api:1.3.2'
    // 你的Spring Boot其他依赖...
}

// 确保注解处理器路径被Gradle正确识别
compileJava {
    options.annotationProcessorPath = configurations.annotationProcessor
}

2. 检查IntelliJ IDEA的注解处理器开关 #

很多时候IDEA默认没有开启注解处理器，导致QClass无法生成或被IDE识别：

• 打开File > Settings > Build, Execution, Deployment > Compiler > Annotation Processors
• 勾选Enable annotation processing选项
• 确认Processor path中包含querydsl-apt和javax.annotation-api的依赖项
• 可以将Generated sources directory设置为build/generated/sources/annotationProcessor/java/main，让IDEA自动识别生成的QClass文件

3. 清理旧构建文件并重新编译 #

旧的生成文件或缓存可能导致冲突，执行以下步骤重置构建状态：

• 先运行Gradle的clean任务（在IDEA的Gradle面板找到Tasks > build > clean）
• 然后执行compileJava任务，或者直接点击IDEA的Build > Rebuild Project
• 最后刷新Gradle依赖（点击Gradle面板顶部的刷新按钮）

4. 添加Java 9模块化兼容参数 #

即使你没有添加module-info.java，Java 9的模块系统仍可能影响注解的处理，需要在编译或运行时添加VM参数：

在Gradle中配置编译参数： #

compileJava {
    options.compilerArgs += ['--add-modules', 'java.xml.bind,java.annotation']
}

在IDEA运行配置中添加VM参数： #

在你的Spring Boot应用运行配置里，找到VM options，添加：

--add-modules java.xml.bind,java.annotation

按照这个顺序排查，应该能解决QClass无法正常工作的问题。

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