HQL查询报unexpected AST node: CASE语法异常如何解决

报错的核心原因是HQL的WHERE子句不支持直接把CASE WHEN表达式作为布尔判断条件使用。
你写的CASE逻辑没有定义ELSE分支，当:searchString为NULL时，整个CASE表达式返回值为NULL，不属于WHERE子句要求的布尔类型（true/false），Hibernate的HQL语法解析器无法识别这种非布尔类型的CASE节点，所以抛出unexpected AST node: CASE的语法错误。
另外顺带提一句，拼接HQL字符串的时候要留意每个片段前后的空格，很多莫名其妙的HQL语法错误都是拼接时漏空格导致的。

你原本想实现的逻辑是：当searchString不为空时，加员工姓名模糊匹配的过滤条件；searchString为空时，不加这个过滤。完全没必要用CASE WHEN实现，两种常用写法都可以正常运行：

方式1：用OR逻辑写等价布尔表达式 #

直接把原来包裹CASE的AND块替换成如下内容即可，逻辑和你预期完全一致：

" AND (:searchString IS NULL OR CONCAT(e.firstName, ' ', e.lastName) LIKE CONCAT('%', TRIM(:searchString), '%')) "

执行逻辑：

• 传入的searchString为NULL时，:searchString IS NULL判定为真，整个OR条件直接成立，不会执行后面的LIKE匹配，相当于跳过姓名过滤
• 传入的searchString不为NULL时，才会执行姓名的模糊匹配逻辑

方式2：代码层动态拼接HQL #

如果不想让数据库做多余的条件判断，也可以在Java代码层提前判断searchString是否有效，动态拼接需要的HQL片段：

// 先拼接基础固定HQL
StringBuilder hqlBuilder = new StringBuilder();
hqlBuilder.append("SELECT DISTINCT e ")
        .append("FROM Employee e ")
        .append("INNER JOIN Requisition r on r.supervisor = e.id ")
        .append("WHERE r.status = 'Open' ")
        .append("AND r.isEvergreen = false ")
        .append("AND r.isConfidential = false ")
        .append("AND r.employmentType != 'Intern (Fixed Term)' ");

// 仅当searchString有效时，才拼接模糊查询条件
if (searchString != null && !searchString.trim().isEmpty()) {
    hqlBuilder.append("AND CONCAT(e.firstName, ' ', e.lastName) LIKE CONCAT('%', TRIM(:searchString), '%') ");
}

hqlBuilder.append("ORDER BY e.firstName, e.lastName");

Query query = session.createQuery(hqlBuilder.toString());
// 仅当拼接了模糊查询条件时，才绑定参数
if (searchString != null && !searchString.trim().isEmpty()) {
    query.setParameter("searchString", searchString);
}

这种写法生成的SQL更简洁，执行效率也会略高一点，适合查询条件比较多的动态查询场景。

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