使用CriteriaQuery统计实体子项时出现格式错误的数值常量问题

嘿，这个错误我之前踩过坑！大概率是你在构建Count查询的时候，路径表达式或者聚合函数的用法出了问题，尤其是处理父子关联的Join环节，导致Hibernate生成了语法畸形的SQL（比如莫名多了个点）。

常见问题原因拆解 #

1. Count函数参数使用不当：直接对整个实体对象或Join对象调用count()，而不是指定具体字段，会导致Hibernate生成类似count(libraryitem0_.)的错误SQL。
2. 关联路径拼写错误：实体中关联子项的属性名（比如children）和代码中引用的名称不一致，导致Hibernate无法正确解析路径，生成错误的SQL片段。
3. Join类型或关联方式错误：没有正确关联Itemlisting表的父子关系，导致查询逻辑混乱，进而触发语法错误。

正确实现示例 #

假设你的实体结构是这样的（对应Itemlisting表的父子关联）：

@Entity
public class LibraryItem {
    @Id
    private Long id;

    // 通过Itemlisting表关联子项
    @OneToMany
    @JoinTable(
        name = "Itemlisting",
        joinColumns = @JoinColumn(name = "parent_id"),
        inverseJoinColumns = @JoinColumn(name = "child_id")
    )
    private List<LibraryItem> children;

    // 其他字段、getter/setter
}

下面是正确的CriteriaBuilder统计代码：

public long countChildItems(Long parentItemId, EntityManager em) {
    CriteriaBuilder cb = em.getCriteriaBuilder();
    CriteriaQuery<Long> countQuery = cb.createQuery(Long.class);

    // 以父项为根实体
    Root<LibraryItem> parentRoot = countQuery.from(LibraryItem.class);
    // 关联子项集合（通过Itemlisting表的映射）
    Join<LibraryItem, LibraryItem> childrenJoin = parentRoot.join("children", JoinType.LEFT);

    // 过滤指定父项ID
    countQuery.where(cb.equal(parentRoot.get("id"), parentItemId));

    // 统计子项数量：指定具体字段（比如子项的ID），避免生成错误的SQL
    countQuery.select(cb.count(childrenJoin.get("id")));

    // 执行查询，没有子项时会返回0
    return em.createQuery(countQuery).getSingleResult();
}

关键调试技巧 #

1. 开启SQL日志：查看Hibernate生成的SQL语句，直接定位那个多余的点出现在哪里。在配置文件中添加：

   hibernate.show_sql=true
   hibernate.format_sql=true
   

2. 检查关联路径：确保代码中引用的关联属性名（比如children）和实体类中的定义完全一致，大小写也要注意。
3. 避免count整个对象：始终指定具体的字段（比如id）作为count()的参数，不要直接传入Root或Join对象。

错误示例对比 #

比如你可能写了这样的错误代码：

// 错误：直接count Join对象，会导致生成count(.)的畸形SQL
countQuery.select(cb.count(childrenJoin));

这种写法会让Hibernate生成类似count(itemlisting1_.)的错误SQL，触发你遇到的“malformed numeric constant: .”错误。

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