Hibernate HQL查询报错：varchar转smalldatetime类型超出范围

这问题我之前碰到过类似的，核心原因通常是字符串日期的格式/精度不匹配数据库要求，或者Hibernate没有正确处理日期类型转换，咱们一步步来捋清楚解决办法：

可能的原因分析 #

1. smalldatetime的精度限制：SQL Server的smalldatetime类型只支持到分钟级精度，有效范围是1900-01-01到2079-06-06。你用的日期字符串带了毫秒（比如'2018-04-26 07:59:00.0'），数据库在转换时会因为无法识别毫秒部分抛出超出范围的错误。
2. 硬编码字符串的转换风险：直接在HQL里写字符串日期，Hibernate可能不会自动做类型映射，而是让数据库直接把varchar转成smalldatetime，这种转换很容易受数据库区域设置、格式规范影响——单个条件时可能刚好侥幸成功，多个条件叠加就触发了错误。

解决方案 #

1. 优先使用参数化查询（最推荐） #

参数化查询能让Hibernate自动处理日期类型的转换，完全避免字符串转日期的问题，同时还能防止SQL注入。示例代码如下：

// 定义带参数的HQL
String hql = "from StopsRegister s where s.startTime >= :startDate and s.endTime <= :endDate";

Query<StopsRegister> query = session.createQuery(hql, StopsRegister.class);
// 用日期类型（比如LocalDateTime或Date）传参，不用手动拼接字符串
query.setParameter("startDate", LocalDateTime.of(2018, 4, 25, 7, 59, 0));
query.setParameter("endDate", LocalDateTime.of(2018, 4, 26, 7, 59, 0));

List<StopsRegister> results = query.getResultList();

这样Hibernate会根据你的实体类字段类型（比如LocalDateTime）和数据库的smalldatetime类型自动生成正确的转换逻辑，彻底规避格式问题。

2. 修正日期字符串的格式（临时方案） #

如果你必须硬编码日期字符串，要去掉毫秒部分，并且使用SQL Server认可的标准格式：

from StopsRegister s where s.startTime >= '2018-04-25 07:59:00' and s.endTime <= '2018-04-26 07:59:00'

注意：这种方式仍然依赖数据库的区域设置，不如参数化查询可靠，不建议长期使用。

3. 检查实体类与数据库字段的类型匹配 #

确保你的StopsRegister实体类中，startTime和endTime字段的类型是java.util.Date、java.time.LocalDateTime这类日期类型，而不是String；同时数据库对应的字段是smalldatetime（或datetime），而不是varchar。类型不匹配是这类转换错误的常见根源。

4. 关于BETWEEN查询的注意点 #

你提到的BETWEEN查询暂时没报错，可能是因为两个日期都没有毫秒部分，但同样建议改成参数化查询，避免后续出现类似问题。

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