使用@ManyToOne时JPASQLQuery的WHERE条件失效问题排查

你遇到的问题核心在于JPASQLQuery和JPAQuery的本质区别：JPAQuery是基于JPA实体模型的查询，能自动解析实体间的关联映射（比如@ManyToOne）；而JPASQLQuery是直接操作SQL表的底层查询，它依赖SQL元模型（基于数据库表结构生成的Q类），不理解JPA的关联注解，所以不能直接使用pc.person.id这种实体关联路径。

错误原因 #

你在JPASQLQuery中使用pc.person.id时，QueryDSL无法正确解析这个JPA关联路径，只能尝试将其转换为SQL语法，最终生成了重复且错误的personCertificate.person.id条件——实际上你的数据库表中根本不存在person这个字段，只有外键person_id。

修正步骤 #

1. 确认SQL元模型的字段

首先确保你的QueryDSL SQL元模型类（比如QPersonCertificate）中包含了对应数据库外键的字段personId（对应表中的person_id）。如果元模型没生成这个字段，需要检查你的QueryDSL配置，确保是基于数据库表生成SQL元模型，而不是JPA实体的元模型。

2. 修改查询条件为外键字段

将where条件中的pc.person.id.eq(personId)替换为直接使用外键字段pc.personId.eq(personId)，修正后的代码如下：

val sqlQuery = JPASQLQuery(
    entityManager,
    MySQLTemplates.builder()
        .build()
)
val resultList = sqlQuery
    .from(pc)
    .where(pc.personId.eq(personId)) // 使用SQL元模型的外键字段
    .fetch()

3. 关联表（如果需要）

如果你需要关联person表查询其他字段，需要手动在JPASQLQuery中添加join操作，比如：

val qPerson = QPerson.person
val resultList = sqlQuery
    .from(pc)
    .innerJoin(qPerson).on(pc.personId.eq(qPerson.id))
    .where(qPerson.id.eq(personId))
    .fetch()

4. 使用SQLExpressions.datediff的示例

现在你可以正常使用SQLExpressions.datediff来进行日期计算了，比如计算证书过期剩余天数：

val dateDiff = SQLExpressions.datediff(pc.expirationDate, SQLExpressions.currentDate())
val resultList = sqlQuery
    .from(pc)
    .where(pc.personId.eq(personId))
    .select(pc, dateDiff) // 同时查询实体和计算结果
    .fetch()

总结 #

JPASQLQuery更贴近原生SQL，需要你用数据库表的实际字段和关联逻辑来编写查询，而不是依赖JPA实体的关联注解。这也是它支持datediff这类原生SQL函数的原因——代价就是需要手动处理表关联和字段引用。

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