Hibernate执行原生更新语句未修改数据库数据问题排查

嘿，我来帮你捋捋这个问题——这种「SQL在控制台跑正常，Hibernate执行却没效果」的情况，我之前也碰到过几次，大概率是参数绑定或者会话层面的细节没处理好，咱们一步步来排查：

1. 参数类型不匹配（最可能的元凶） #

看你贴的Hibernate日志，returnAction这个参数被绑定成了VARBINARY类型：

19:47:29,049 TRACE [org.hibernate.type.descriptor.sql.BasicBinder] - binding parameter [2] as [VARBINARY] - [RETURNTOCLIENT]

但你在MySQL控制台执行时，是直接用字符串RETURNTOCLIENT匹配的。如果数据库里product_item.returnAction字段是VARCHAR或者CHAR类型，二进制类型的参数和字符串值做比较是不相等的，这就导致WHERE条件根本命中不了任何行，自然没数据被更新。

解决办法：
显式指定参数的字符串类型，强制Hibernate用正确的类型绑定：

.setParameter("returnAction", receptacle.getReturnAction(), StringType.INSTANCE)

另外也可以检查下你的实体类，确认returnAction字段的注解是否正确映射了数据库类型，比如：

@Column(name = "returnAction", columnDefinition = "VARCHAR(50)")
private String returnAction;

2. 原生SQL命名参数的小坑 #

Hibernate对原生SQL的命名参数支持，在某些版本或者复杂SQL（比如带JOIN的）场景下偶尔会有小问题。虽然从日志看参数顺序是对的，但咱们可以换个方式验证——改用位置参数试试：

em.createNativeQuery("UPDATE product_item pi" + 
                    " JOIN ereturn er ON pi.ereturn = er.id " + 
                    "SET pi.receptacle = ? " + 
                    "WHERE pi.returnAction = ? " + 
                    "AND er.destination = ? " + 
                    "AND er.status = 'RECEIVED'")
  .setParameter(1, receptacle.getId())
  .setParameter(2, receptacle.getReturnAction())
  .setParameter(3, receptacle.getDestination().getId())
  .executeUpdate();

如果用位置参数能正常更新，那就是命名参数的映射出了问题。

3. Persist后的ID可能还没同步到数据库 #

你在执行UPDATE前调用了em.persist(receptacle)，如果这个receptacle是新创建的实体，而且主键是数据库自增的，Hibernate默认会等到事务提交时才把插入操作Flush到数据库。这时候receptacle.getId()拿到的可能是Hibernate生成的临时ID，不是数据库实际生成的真实ID，那UPDATE语句用这个ID自然找不到对应的行。

解决办法：
在persist之后手动触发Flush，确保ID被数据库生成并同步到实体对象：

em.persist(receptacle);
em.flush(); // 手动Flush，获取数据库真实生成的ID

4. 事务或缓存导致的数据不一致 #

如果这段代码执行时，有其他事务在修改相同的数据，或者Hibernate的一级缓存里存的是旧数据，可能导致当前会话看不到符合条件的行。不过这个概率比较低，毕竟你在控制台能查到数据。

验证方法：
可以在执行UPDATE前加个查询，看看Hibernate会话里能查到多少符合条件的行：

Long matchCount = ((Number) em.createNativeQuery("SELECT COUNT(*) FROM product_item pi" + 
                                                " JOIN ereturn er ON pi.ereturn = er.id " + 
                                                "WHERE pi.returnAction = :returnAction " + 
                                                "AND er.destination = :destination " + 
                                                "AND er.status = 'RECEIVED'")
                              .setParameter("returnAction", receptacle.getReturnAction())
                              .setParameter("destination", receptacle.getDestination().getId())
                              .getSingleResult()).longValue();
System.out.println("当前会话中符合条件的行数：" + matchCount);

如果输出是0，那说明Hibernate会话里的数据和控制台不一致，得检查事务隔离级别或者缓存配置了。

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