基于Hibernate HQL按传入日期查询Order实体列表的报错问题

两个连续报错的触发原因非常直接，无复杂隐藏问题：

• 抛出could not resolve property: orderdate of: com.cg.oam.entities.Order：HQL语法的解析规则是匹配Java实体类的属性名，不是映射后的数据库表列名。你的实体类里日期属性是驼峰命名orderDate，对应数据库表的列是小写格式orderdate，编写HQL时误用了数据库列名做查询条件，自然无法匹配到实体属性。
• 抛出Named parameter not bound : date：修正属性拼写为orderDate后，仅声明了带命名参数的查询语句，全程未调用参数绑定逻辑，将传入的LocalDate date入参赋值给命名参数，Hibernate检测到未绑定值的命名参数就会抛出该异常。
• 现有逻辑冗余：纯查询操作无需开启数据库事务；每次方法调用都创建、销毁EntityManagerFactory和EntityManager，在JUnit测试场景下会大幅增加运行耗时。

@Override
public List<Order> showAllOrders(LocalDate date) {
    EntityManagerFactory emf = Persistence.createEntityManagerFactory("JPA-PU");
    EntityManager em = emf.createEntityManager();

    // HQL用实体驼峰属性orderDate做查询字段，显式绑定命名参数的实际入参值
    List<Order> orders = em.createQuery(
            "from Order ord where ord.orderDate = :queryDate", Order.class)
            .setParameter("queryDate", date)
            .getResultList();

    em.close();
    emf.close();
    return orders;
}

• 不要在业务方法内部重复初始化EntityManagerFactory，建议在测试类的@BeforeAll注解方法中统一初始化EMF，在@AfterAll注解方法中统一销毁，避免测试用例执行时反复重建数据库连接池、拖慢测试效率。
• 验证查询逻辑时，可直接使用示例表中的日期值（LocalDate.of(2020,1,8)、LocalDate.of(2018,1,8)）作为入参，可直接匹配返回对应记录，快速校验结果正确性。
• 代码中指定查询返回类型为Order.class是Hibernate6+的强类型写法，可以避免原生类型擦除带来的未检查类型警告。

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