Hibernate原生查询报ORDER附近语法错误问题排查

我希望通过Hibernate的persistence.query执行一条查询，编写的代码如下：

final String StatusQuery = convertStringFiltersToQuery(StatusFilters);

 sql = String.format("Select * FROM Program p LEFT JOIN p.user vt LEFT JOIN vt.Vendor LEFT JOIN p.Program WHERE vt.Status IN (%s) ORDER BY ID DESC",
                StatusQuery);

entityManager.createNativeQuery(sql).getResultList();

执行时出现错误：

Caused by: org.postgresql.util.PSQLException: ERROR: syntax error at or near "ORDER"

根据建议修改代码后仍报相同错误，修改后的代码如下：

sql = String.format("Select * FROM Program p LEFT JOIN p.user vt LEFT JOIN vt.Vendor LEFT JOIN p.Program on (p.program_id = p.UserProgram.program_id) WHERE vt.Status IN (%s) ORDER BY ID DESC",

请问我遗漏了什么？

核心错误原因 #

你的代码混淆了HQL（Hibernate查询语言）和原生SQL的语法规则，同时SQL语句存在多处无效关联、逻辑错误，导致PostgreSQL解析时出现语法错误。

具体错误点及修复 #

1. 原生SQL不能使用HQL的对象关联语法 #

你使用createNativeQuery执行原生SQL，但写的LEFT JOIN p.user vt是HQL的写法（通过实体类的关联属性关联）。原生SQL必须使用数据库的实际表名、字段名，并显式指定关联条件，不能用实体类的属性名。

比如如果Program对应数据库表program，user对应表user（PostgreSQL中user是关键字，需要加双引号），关联字段是program.user_id = user.id，正确写法应为：

LEFT JOIN "user" vt ON p.user_id = vt.id

2. 重复且无效的JOIN语句 #

原SQL中FROM Program p ... LEFT JOIN p.Program完全错误：

• 已经从Program p开始查询，无需重复JOIN自身
• 即使需要自关联，也必须使用正确的别名和关联条件，而非p.Program这种无效写法

3. 关联条件逻辑错误 #

修改后的代码中LEFT JOIN p.Program on (p.program_id = p.UserProgram.program_id存在两处错误：

• p.Program是无效的表引用，别名p已经代表Program表，不能再用p.Program
• p.UserProgram是错误的引用，p是Program的别名，不存在UserProgram这个关联，需替换为实际的表名和关联字段

4. IN子句参数格式问题 #

StatusQuery生成的参数必须是带单引号的字符串格式（比如'ACTIVE','INACTIVE'），如果生成的是不带引号的逗号分隔值，会直接导致SQL语法错误，进而让数据库认为后续的ORDER BY是语法错误。

修正后的示例代码 #

假设你的数据库表结构为：

• program表：program_id（主键）、user_id（关联用户表）
• user表：id（主键）、status、vendor_id（关联供应商表）
• vendor表：id（主键）

原生SQL版本 #

final String statusQuery = convertStringFiltersToQuery(statusFilters);
// 确保statusQuery生成的是带单引号的格式，例如"'ACTIVE','INACTIVE'"
String sql = String.format(
    "SELECT * FROM program p " +
    "LEFT JOIN \"user\" vt ON p.user_id = vt.id " +
    "LEFT JOIN vendor v ON vt.vendor_id = v.id " +
    "WHERE vt.status IN (%s) " +
    "ORDER BY p.program_id DESC",
    statusQuery
);
entityManager.createNativeQuery(sql).getResultList();

HQL版本（推荐，无需关心表名细节） #

如果想使用HQL的对象关联语法（如p.user），应使用createQuery而非createNativeQuery：

final String statusQuery = convertStringFiltersToQuery(statusFilters);
String hql = String.format(
    "SELECT p FROM Program p " +
    "LEFT JOIN p.user vt " +
    "LEFT JOIN vt.vendor " +
    "WHERE vt.status IN (%s) " +
    "ORDER BY p.programId DESC",
    statusQuery
);
entityManager.createQuery(hql, Program.class).getResultList();

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