Java 8+ 项目必须用 annotationProcessor 而非 apt，因 querydsl-apt 的 apt 插件已废弃；Spring Boot 2.4+ 需显式配置 annotationProcessorPaths，且 querydsl-jpa 与 querydsl-apt 版本须严格一致（如均为 5.0.0），并适配 Jakarta EE 9+。

Querydsl代码生成插件选哪个：apt 还是 annotationProcessor？

Java 8+ 项目里，querydsl-apt 的 apt 插件已废弃，必须用 annotationProcessor。Maven 中若还写 apt-maven-plugin，编译会静默跳过生成，Q类一个都不出来——连报错都没有，最坑。

• Spring Boot 2.4+ 默认禁用 annotationProcessor 路径扫描，得显式开启：maven-compiler-plugin 配置里加 <annotationprocessorpaths></annotationprocessorpaths>，不能只靠 dependencies 里的 provided 依赖
• querydsl-jpa 和 querydsl-apt 版本必须严格对齐，比如都用 5.0.0；混用 5.0.0 + 4.4.0 会导致 QEntity 字段缺失或类型错误
• 实体类上没加 @Entity 或用了 Lombok 的 @Data 却没配 lombok.config 开启 lombok.anyConstructor.addConstructorProperties=true，Q类可能生成失败或字段为空

Querydsl依赖怎么配才不冲突：JPA、Spring Data、Gradle 多版本陷阱

Spring Boot 3.x 默认用 Jakarta EE 9+（jakarta.persistence.*），但老版 querydsl-jpa（如 4.4.0）仍依赖 javax.persistence.*，直接引入会 ClassNotFound。

• Spring Boot 3+ 必须用 querydsl-jpa 5.0.0 及以上，且确认其 POM 里引用的是 jakarta.persistence-api
• 如果项目里手动引入了 hibernate-core，版本要和 Spring Boot 的 spring-boot-starter-data-jpa 内置版本一致，否则 QuerydslJpaPredicateExecutor 可能因 Predicate 解析器不兼容而抛 IllegalArgumentException: unexpected predicate
• Gradle 用户注意：annotationProcessor 不会自动继承 compileOnly 的依赖，querydsl-apt 必须单独声明在 annotationProcessor 配置块中，不能只写在 implementation

Q类生成路径不对、找不到 QUser 怎么办

生成的 QUser.java 默认在 target/generated-sources/java/ 下，但 IDE（尤其 IntelliJ）常不识别该目录为 source root，导致编译报错“cannot resolve symbol QUser”。

Java调试

通过 JDWP 实现 Java 远程调试：连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。 术语注解 JDWP：Java Debug Wire Protocol，Java 调试有线协议（Java 远程调试底层通信协议） remote JVM：远程 Java 虚拟机 step through code：代码单步调试（步入 / 步过 / 步出调试） inspect variables：变量查看 / 变量检视 stac

下载

• Maven 用户：确保 maven-compiler-plugin 启用了 generatedSourcesDirectory，并配合 build-helper-maven-plugin 把该路径加入 source roots
• IntelliJ：右键 target/generated-sources/java → “Mark as Generated Sources Root”，别信自动导入——它经常漏掉
• 如果用了 @QueryEntity 但没生效，检查是否在实体类同包下存在 package-info.java 且含 @QueryEntities 注解，否则 Querydsl 默认只扫 @Entity 类，忽略普通 POJO

Spring Data JPA 继承 QuerydslPredicateExecutor 编译不过

接口继承 QuerydslPredicateExecutor<user></user> 后编译报错 “cannot access QUser”，通常不是代码问题，而是 Q类没被正确编译进 classpath 或类型擦除干扰。

立即学习“Java免费学习笔记（深入）”；

• 确认 QUser 所在包与 User 实体完全一致（包括子包），Querydsl 默认按包名映射，com.example.model.User 对应 com.example.model.QUser，错一个字母都不行
• Spring Boot 3.1+ 若启用 spring.jpa.hibernate.use-new-id-generator-mappings=true（默认值），需确保 QUser 中主键字段类型与实体中 @Id 字段实际类型一致（例如 Long vs long），否则泛型推导失败
• IDE 缓存常导致假性报错：Clean 项目后，先 mvn compile 命令行跑通，再刷新 IDEA，别直接点 rebuild

事情说清了就结束。最麻烦的永远不是配置本身，而是生成路径没被识别、依赖版本错位、还有 IDE 缓存装死——这三样加一起，能让你对着 QUser 发十分钟呆。