使用Criteria构建复杂查询遇阻，求解决方案（含SQL参考）

我来帮你捋捋这个问题——你碰到的org.hibernate.criterion.DetachedCriteria cannot be cast to java.util.Date错误，本质是类型不匹配：你大概率在Criteria的条件约束里，误把DetachedCriteria实例当成日期参数传进去了，而不是你定义的start/end日期对象。下面给你具体的排查和解决方向：

1. 先定位参数绑定的错误点 #

先检查你新尝试的代码，是不是出现了类似这样的写法：

// 错误示例：把DetachedCriteria当成日期参数传给between
DetachedCriteria subQuery = ...;
criteria.add(Restrictions.between("createTime", subQuery, end));

这种写法完全错误，between方法的第二、第三个参数必须是Date类型的start和end，而不是子查询对象。

2. 正确使用DetachedCriteria做子查询 #

如果你的复杂查询需要用到子查询，必须通过Subqueries工具类来关联，而不是直接把DetachedCriteria当参数。举个典型的子查询用法示例：

// 构建离线子查询：比如获取某个时间范围内的订单ID
DetachedCriteria orderSubQuery = DetachedCriteria.forClass(Order.class)
    .setProjection(Projections.property("id")) // 指定子查询返回的字段（投影）
    .add(Restrictions.between("createTime", start, end));

// 主查询：关联子查询结果
Criteria customerCriteria = session.createCriteria(Customer.class)
    .add(Subqueries.propertyIn("orderId", orderSubQuery)); // 用Subqueries对接子查询

这里要注意：子查询的投影字段（比如上面的id）必须和主查询中关联的字段（orderId）类型一致。

3. 回归SQL需求，对齐Criteria写法 #

既然你已经有明确的SQL语句，可以把SQL拆解后对应到Criteria的API：

• 多表关联：用createAlias或createCriteria
• 分组/聚合：用setProjection配合Projections.groupProperty、Projections.sum()等
• 日期范围：直接用Restrictions.between("dateColumn", start, end)，确保start/end是java.util.Date类型（可以用SimpleDateFormat把字符串转成Date）：

  SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
  Date start = sdf.parse("2015-01-01");
  Date end = sdf.parse("2016-01-01");
  

4. 常见误区避坑 #

• 别混淆Criteria和DetachedCriteria的场景：DetachedCriteria是离线查询，可以先在没有Session的环境下构建，之后要么通过getExecutableCriteria(session)转成可执行的Criteria，要么作为子查询用在Subqueries方法里。
• 不要在Restrictions的条件方法（eq/gt/between等）里传入非参数类型的对象，所有参数必须和实体类字段类型匹配。

如果还是卡壳，建议把你的尝试代码和对应的SQL语句贴出来，能更精准地定位问题~

内容的提问来源于stack exchange，提问作者C.Norris