JPA findFirstBy方法报错：期望1条结果却找到5条，如何解决？

问题原因 #

你遇到的报错是因为数据库中存在5条cid相同且dt为最新日期的记录。JPA的findFirstByCidOrderByDtDesc方法返回单个Ret实体时，会严格校验结果集数量：如果实际匹配结果超过1条，就会抛出"Expected 1 but found N"的异常；而返回List<Ret>时会直接返回所有匹配结果，因此不会报错。

解决方案 #

1. 用findTop1明确限制结果数量 #

修改方法定义为：

Ret findTop1ByCidOrderByDtDesc(String cid);

findTop1会直接返回排序后的第一条数据，即使存在多条同最新dt的记录，也只会取第一条返回，不会触发数量校验异常。

2. 使用Optional<Ret>作为返回类型 #

用Optional包装实体类，既可以避免空指针问题，也能让JPA兼容多结果场景（自动取第一条封装）：

Optional<Ret> findFirstByCidOrderByDtDesc(String cid);

调用时通过Optional的orElse(null)、orElseThrow()等方法处理结果即可。

3. 自定义JPQL/SQL精确控制 #

如果需要更灵活的查询逻辑，可以写自定义JPQL（适配所有数据库）或原生SQL：

@Query("SELECT r FROM Ret r WHERE r.cid = :cid ORDER BY r.dt DESC")
@MaxResults(1)
Ret findLatestByCid(@Param("cid") String cid);

或者针对MySQL用LIMIT：

@Query(value = "SELECT * FROM ret WHERE cid = :cid ORDER BY dt DESC LIMIT 1", nativeQuery = true)
Ret findLatestByCid(@Param("cid") String cid);

额外建议 #

如果业务逻辑要求同一cid的最新日期数据必须唯一，建议给cid和dt组合添加唯一约束，或者优化dt字段的精度（比如包含时分秒），从根源避免多条重复的最新数据。

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