Grails中HQL多关联左外连接查询结果异常问题排查

核心原因 #

你的查询仅返回同时包含products和services的Order，本质是当Order仅含其中一类关联时，另一类左外连接的结果为null，此时访问null对象的属性（如s.item.name）会得到null，而null LIKE 任意值在SQL中会被判定为false。虽然OR逻辑理论上只要有一个条件为true就会生效，但未对null关联做判断的写法，会隐性过滤掉仅含单类关联的匹配结果。

修正后的HQL查询 #

将针对p和s的条件分别用p IS NOT NULL和s IS NOT NULL包裹，确保只有当关联存在时才检查其属性，避免null属性判断干扰整体逻辑：

SELECT DISTINCT o 
FROM Order o 
LEFT OUTER JOIN o.store.managers AS m 
LEFT OUTER JOIN o.products AS p 
LEFT OUTER JOIN o.services AS s 
WHERE o.store = :store 
  AND m.id = :userId  -- 注：o.store = :store已确保o.store不为null，无需重复判断o.store IS NULL
  AND (TRIM(LOWER(o.identifier)) LIKE LOWER(:keywords) OR 
       TRIM(LOWER(o.description)) LIKE LOWER(:keywords) OR 
       TRIM(LOWER(o.customer.name)) LIKE LOWER(:keywords) OR 
       TRIM(LOWER(o.customer.description)) LIKE LOWER(:keywords) OR 
       TRIM(LOWER(o.customer.phone)) LIKE LOWER(:keywords) OR 
       (p IS NOT NULL AND (TRIM(LOWER(p.item.name)) LIKE LOWER(:keywords) OR 
                           TRIM(LOWER(p.item.product.name)) LIKE LOWER(:keywords) OR 
                           TRIM(LOWER(p.item.product.specifications)) LIKE LOWER(:keywords) OR 
                           TRIM(LOWER(p.item.product.brand)) LIKE LOWER(:keywords))) OR 
       (s IS NOT NULL AND (TRIM(LOWER(s.item.name)) LIKE LOWER(:keywords) OR 
                           TRIM(LOWER(s.item.specifications)) LIKE LOWER(:keywords)))) 
ORDER BY o.orderTime desc

额外验证点 #

1. 通配符检查：确保传入的:keywords参数包含%通配符（如%xxx%），否则LIKE只会匹配完全一致的字符串，导致部分预期结果无法返回。
2. 关联非空性确认：检查OrderProductItem.item和OrderServiceItem.item在领域类中是否配置为非空（nullable: false），避免因关联对象为null导致属性判断失效。
3. StoreManager条件简化：由于o.store = :store已确保o.store不为null，原条件(o.store IS NULL OR m.id = :userId)可直接简化为m.id = :userId，减少逻辑冗余。

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