本文详解为何原生 SQL 风格 JPQL（含 NOT IN 子查询和表别名）会触发 Hibernate 的 SemanticException，并提供符合 JPA 规范、基于实体关系的正确 JPQL 写法，实现“查找指定位置且无任何 ReservedSlot 关联的 DiningTable”这一业务需求。
本文详解为何原生 sql 风格 jpql（含 `not in` 子查询和表别名）会触发 hibernate 的 semanticexception，并提供符合 jpa 规范、基于实体关系的正确 jpql 写法，实现“查找指定位置且无任何 reservedslot 关联的 diningtable”这一业务需求。
在 JPA 中，TypedQuery 所执行的并非原生 SQL，而是 JPQL（Java Persistence Query Language） —— 一种面向对象的查询语言，其操作对象是实体类及其属性，而非数据库表与字段。因此，直接书写 select * from dining_table dt 或 select dining_table_id from reserved_slot 这类 SQL 语法，会因违反 JPQL 语义规则而抛出 SemanticException。
根本原因在于：
- JPQL 不支持 SELECT *，必须显式指定实体或属性（如 SELECT dt）；
- 表别名（如 dining_table dt）应替换为实体别名（如 DiningTable dt）；
- 子查询中引用的 dining_table_id 是数据库列名，JPQL 要求使用关联属性路径（如 rs.diningTable.id），且子查询本身在 JPQL 中受限（尤其跨实体时易出错）；
- NOT IN 子查询若返回 NULL，还可能引发逻辑陷阱（空值传播问题），而 LEFT JOIN ... IS NULL 是更安全、更符合 JPA 惯用的空关联判断方式。
✅ 正确写法应基于实体映射关系，利用 LEFT JOIN 检测一对多关联为空的状态：
String jpql = "SELECT dt FROM DiningTable dt " +
"LEFT JOIN dt.reservedSlots rs " +
"WHERE dt.tableLocation = :location " +
"AND rs.id IS NULL";
TypedQuery<DiningTable> query = entityManager.createQuery(jpql, DiningTable.class);
query.setParameter("location", location); // 使用命名参数，更清晰、更安全
List<DiningTable> emptyTables = query.getResultList();? 关键要点说明：
- dt.reservedSlots 是 DiningTable 实体中声明的 @OneToMany 关联集合属性，JPQL 可直接导航；
- LEFT JOIN dt.reservedSlots rs 表示对每个 DiningTable 尝试关联其所有 ReservedSlot，若无则 rs 为 NULL；
- rs.id IS NULL 精准筛选出“没有任何 ReservedSlot 关联”的餐桌（即空闲餐桌）；
- 使用命名参数 :location 替代位置参数 ?1，提升可读性与可维护性，并自动适配 TableLocation 枚举类型（无需手动转换）；
- 注意：tableLocation 是 Java 属性名（对应 @Column(name="LOCATION")），JPQL 中必须使用属性名，而非数据库列名。
⚠️ 注意事项：
- 确保 reservedSlots 集合在 DiningTable 中已正确配置 mappedBy（当前代码已满足）；
- 若性能敏感，可考虑添加数据库索引：CREATE INDEX idx_reservedslot_diningtable_id ON reserved_slot(dining_table_id);；
- 避免在 JPQL 中拼接字符串构建查询条件——应始终使用参数化查询，防止注入与类型错误；
- 如需支持复杂动态条件（如位置可选、容量过滤等），推荐改用 Criteria API 或 QueryDSL，以获得编译期类型安全。
综上，JPA 查询的本质是“操作对象图”，而非“操作数据表”。摒弃 SQL 思维，转向实体关系建模与导航，是写出健壮、可移植 JPQL 的关键。
