必须用 Maven 插件生成 Q 类，否则 Querydsl 查询无法运行；Spring Boot 3.x + JDK 17+ 推荐 querydsl-apt 配 annotationProcessor，实体需加 @Entity 或 @QueryEntity，路径设为 target/generated-sources/querydsl 并标记为 Sources Root。
Querydsl 在 Java 项目里到底要不要用 Maven 插件生成 Q 类
必须用，不生成 Q 类就根本跑不起来 Querydsl 查询。它不是可选的“增强”，而是运行前提——因为所有类型安全查询都依赖这些编译期生成的静态类。
常见错误现象：Cannot resolve symbol QUser、NoClassDefFoundError: QUser，本质都是没生成或没引入生成的类。
- Spring Boot 3.x + JDK 17+ 推荐用
querydsl-apt插件，配合annotationProcessor路径，别再用老的maven-processor-plugin - 实体类必须带
@Entity（JPA 模式）或显式加@QueryEntity，否则插件默认跳过 - 生成路径建议设为
target/generated-sources/querydsl，并确保 IDE（IntelliJ/Eclipse）把这个目录标记为 Sources Root - Gradle 用户注意：
compileJava任务必须依赖processResources，否则 Q 类可能在 classpath 里“迟到”
Querydsl JPA 和 Querydsl JDBC 的依赖怎么选不冲突
只用一个：JPA 模式下必须用 querydsl-jpa，JDBC 原生模式才用 querydsl-sql；混着引会触发 Multiple bindings for QuerydslConfiguration 错误。
使用场景差异很直接：如果你项目里已经有 JpaRepository、用 @Transactional、走 Hibernate/JPA 生命周期，那就只能走 querydsl-jpa；如果绕过 ORM 直连 DataSource 执行 SQL，才考虑 querydsl-sql。
立即学习“Java免费学习笔记（深入）”；
-
querydsl-jpa依赖隐含了querydsl-core和querydsl-apt，不用重复声明 - Spring Data JPA 用户，要额外加
QuerydslPredicateExecutor到 Repository 接口，否则findAll(Predicate)方法不可用 - 别手动 new
JPAQueryFactory—— 应该从 Spring 容器取@Autowired JPAQueryFactory，否则事务上下文丢失、无法复用 EntityManager
Querydsl Predicate 构建时 null 值和空字符串怎么安全处理
直接拼 user.name.eq("xxx") 遇到 null 就抛 NullPointerException，空字符串则可能查出意外数据；这不是 Querydsl 的 bug，是 Java 语言层面对 null 的硬约束。
最稳妥的做法是把条件判断提到 Predicate 外部，用布尔开关控制是否加入条件，而不是在表达式里做三元运算或 coalesce()。
- 避免写
user.name.eq(name != null ? name : "")—— 空字符串仍会参与匹配，且破坏类型安全 - 推荐写法：
BooleanBuilder builder = new BooleanBuilder(); if (name != null && !name.trim().isEmpty()) { builder.and(user.name.eq(name.trim())); } - 对数字字段做范围查询时，用
gt()/goe()前务必检查参数是否为 null，否则 NPE 发生在.fetch()执行时，堆栈难定位 - 数据库字段允许 NULL 时，慎用
eq(null)—— 它生成的是= NULL（永远 false），要用isNull()或isNotNull()
Querydsl 分页查询为什么 count() 和 fetch() 结果不一致
典型原因是 JPQL 的 COUNT 子句不支持 GROUP BY、DISTINCT 或复杂 JOIN，导致 count 查询被 Querydsl 自动降级成全表扫描，而实际 fetch 是带关联的。
这不是分页写错了，是 JPA 提供的 count 机制天然缺陷，Querydsl 只是忠实地转译。
- 开启
spring.jpa.properties.hibernate.generate_statistics=true，看日志里两个 SQL 是否真不一样 - 若用了
distinct或多对一 JOIN，手动拆分 count：先查主表 ID 列（无 JOIN），再用id.in(...)去 fetch 关联数据 - 别依赖
QuerydslRepositorySupport的内置分页 —— 它底层调用的就是JPAQueryFactory的fetchCount()，问题照旧 - H2 / PostgreSQL 测试时表现正常，但切到 MySQL 8.0+ 可能突然报
Invalid use of group function，这是方言适配不到位的信号
Querydsl 的“类型安全”只管编译期字段名和类型，运行时的 SQL 行为、NULL 语义、分页一致性，全得靠你对 JPA 和数据库的理解兜底。生成 Q 类只是起点，不是终点。
