使用Hibernate更新DATETIME字段报错但setter方法可正常更新的问题求解

为什么setter方式可以更新成功 #

你通过session.get()拿到托管状态的实体对象，调用setter赋值后提交事务时，Hibernate会读取该字段上的@Temporal(TemporalType.DATE)注解配置，自动将java.util.Date类型转换为MySQL DATETIME类型兼容的标准格式写入数据库，全程不会触发Date对象的toString()方法，所以不存在格式不匹配的问题。

为什么HQL字符串拼接方式报错 #

你直接将Date对象拼接到HQL字符串中时，Java会隐式调用Date对象的toString()方法，得到的是Sat Sep 28 00:00:00 IST 2002这种带时区、可读性优先的字符串格式，该格式并不符合MySQL DATETIME字段要求的yyyy-MM-dd HH:mm:ss标准格式，数据库无法识别，就会抛出数据截断错误。

• 禁止使用字符串拼接的方式传入SQL/HQL参数：该方式除了会出现类型格式不匹配问题，还存在严重的SQL注入风险。所有参数都应该使用参数绑定的方式传入，示例代码如下：

Date dob = DateUtils.parseDate("28/09/2002");
session.createQuery("UPDATE Employee SET dateOfBirth = :dob WHERE id = :userId")
    .setParameter("dob", dob)
    .setParameter("userId", 1)
    .executeUpdate();
session.getTransaction().commit();

使用参数绑定时，Hibernate会自动根据字段的注解配置完成Java类型到数据库类型的转换，和setter更新的逻辑完全一致。

• 优先使用Java 8+提供的java.time时间类型：java.util.Date存在时区处理混乱、API难用的问题，Hibernate 5.2及以上版本已经原生支持LocalDate、LocalDateTime等JSR310时间类型，不需要额外添加@Temporal注解，能大幅降低日期类型处理的出错概率。
• 若业务必须手动格式化日期字符串，需要严格对齐数据库支持的标准格式，比如MySQL DATETIME对应的yyyy-MM-dd HH:mm:ss格式。

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