数据库仅一条记录，调用Repository方法触发javax.persistence.NonUniqueResultException求助

• 核对Hibernate实际执行的SQL与你手动运行的是否完全一致
  有时候你复制的SQL没正确替换参数（比如日期、数字类型的参数在Hibernate里的处理和你手动输入的不一样），或者程序里有动态查询条件（比如根据参数是否为空拼接条件），导致两次执行的查询逻辑其实不同。开启Hibernate的参数绑定日志（org.hibernate.type.descriptor.sql.BasicBinder设为DEBUG），能看到程序里实际用的参数值。

• 检查实体映射与关联关系导致的对象重复
  哪怕数据库返回1条SQL结果，Hibernate可能因为关联抓取生成多个实体对象。比如你用JOIN FETCH关联了子表，子表有2条关联记录，SQL返回的是2行笛卡尔积结果，你可能只看主表字段误以为是1条，但Hibernate会映射成2个主实体对象。这种情况要检查关联注解的配置，比如@OneToMany的fetch策略、是否加了distinct。

• 排查缓存干扰
  一级缓存（Session级）或二级缓存里的旧数据可能导致查询结果和数据库实际数据不一致。可以在查询前调用entityManager.clear()清空一级缓存，或者临时关闭二级缓存测试。

• 检查Repository方法的返回逻辑
  如果是自定义@Query方法，确认是否误用了getSingleResult()（这个方法要求结果必须唯一），而查询实际能返回多个对象；如果是Spring Data JPA自动生成的方法，检查方法名是否精准，比如条件是否足够过滤到唯一结果，有没有用返回单个实体的方法匹配到了多条数据。

• 查看Hibernate的加载日志
  开启org.hibernate.loader.Loader的DEBUG日志，能看到Hibernate从结果集中映射出多少个实体对象，以及映射过程，这能帮你定位是SQL结果行数问题，还是映射时生成了重复对象。

• 核对事务与隔离级别
  如果程序在事务内执行查询，事务中未提交的修改会让你看到数据库客户端看不到的数据。比如程序先插入了一条记录没提交，此时事务内查询能看到2条，但手动查数据库只有1条，就会触发这个异常。

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