如何在HQL中对Long类型字段使用LIKE查询？报ClassCastException错误

嘿，这个问题我之前踩过坑！你碰到的java.lang.ClassCastException本质原因很明确：HQL的LIKE操作符是为字符串类型设计的，但你的ID是Long类型——当你传入带%通配符的字符串参数时，Hibernate会自动尝试把这个字符串转换成Long类型，这自然会触发类型转换错误。

给你两种实用的解决思路：

• 方法一：在HQL中把Long类型ID转为字符串再匹配（通用方案）
  直接在HQL语句里用cast函数把ID转换成字符串类型，这样LIKE就能正常工作了。修改后的代码示例如下：

  String hql = "SELECT ... WHERE cast(ID as string) like :searchParam";
  Query query = getSession().createQuery(hql);
  query.setParameter("searchParam", "%" + searchParam + "%");
  data = query.list();
  

  部分Hibernate版本也支持toString(ID)做转换，但cast的兼容性更好，优先推荐这个写法。

• 方法二：数字范围查询（仅适用于前缀匹配场景）
  如果你只需要做前缀匹配（比如搜索以"123"开头的ID），可以把搜索参数转换成数值范围来查询。比如searchParam是"123"，就可以写ID >= 123000 and ID <= 123999。不过这种方法局限性很大，中间或后缀匹配的场景就用不了，所以还是优先选第一种方法。

⚠️ 小提示：用cast转换后，数据库可能无法利用ID上的索引，如果你的表数据量很大，查询性能可能会受影响。这种情况下可以考虑在数据库新增一个ID对应的字符串字段（比如id_str），给这个字段建立索引，直接对字符串字段做LIKE查询，性能会提升不少。

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