HQL查询如何返回productCategory为null的产品数据？

你的查询之所以无法返回productCategory为null的产品，核心原因是：当你在JPQL中直接引用p.productCategory.name时，JPA会自动创建隐式内连接（INNER JOIN），内连接的特性是只保留关联表两边都有匹配数据的记录，因此没有分类的产品会被直接过滤掉，哪怕它们的其他字段（比如name、id）匹配关键词。

修改方案：显式使用左外连接 #

我们需要把隐式内连接改成左外连接（LEFT JOIN），确保没有分类的产品能被保留在结果集中，同时调整条件逻辑避免null值干扰判断。修改后的仓库方法代码如下：

@Query("SELECT p from Product p LEFT JOIN p.productCategory pc " +
       "where cast(p.id as string) like :x " +
       "or p.name like :x " +
       "or p.description like :x " +
       "or p.sku like :x " +
       "or (pc is not null and pc.name like :x)")
public Page<Product> search(@Param("x") String keyword, Pageable pageable);

代码说明 #

• LEFT JOIN p.productCategory pc：显式指定左连接产品与分类，并给分类表起别名pc。左连接会保留所有产品记录，不管它是否关联了分类。
• (pc is not null and pc.name like :x)：只有当分类存在（pc is not null）时，才检查分类名称是否匹配关键词。这样可以避免pc.name为null时，逻辑判断结果为null（在WHERE子句中会被视为false）的问题。

额外调整（按需选择） #

如果你需要无条件包含所有分类为null的产品（不管其他字段是否匹配关键词），可以在WHERE条件末尾追加or pc is null：

@Query("SELECT p from Product p LEFT JOIN p.productCategory pc " +
       "where cast(p.id as string) like :x " +
       "or p.name like :x " +
       "or p.description like :x " +
       "or p.sku like :x " +
       "or (pc is not null and pc.name like :x) " +
       "or pc is null")
public Page<Product> search(@Param("x") String keyword, Pageable pageable);

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