咨询IncorrectResultSizeDataAccessException报错原因及Bug注释添加问题

一、异常产生原因 #

IncorrectResultSizeDataAccessException: query did not return a unique result: 2 这个异常是Spring数据访问组件（比如JdbcTemplate、Spring Data JPA）抛出的，核心原因是：

• 你调用的查询方法要求必须返回且仅返回1条结果（比如findOne()、getSingleResult()这类方法），但实际执行SQL后，数据库返回了2条匹配的记录，不符合方法的预期，因此触发该异常。
• 常见诱因：查询条件不够精准，比如你默认某个字段（如手机号、用户名）是唯一的，但数据库里存在重复值；或者表的唯一性约束（如唯一索引）失效，导致重复数据被插入。

二、Bug中添加更多注释的建议 #

要让Bug信息更清晰，注释里可以补充这些内容：

• 触发场景：明确异常出现的接口/业务逻辑，比如“用户中心-通过手机号查询个人信息接口触发，该接口设计为返回单条用户数据”。
• 查询细节：贴出执行的SQL语句，比如SELECT id, name, phone FROM user WHERE phone = '138xxxx1234'，说明这条SQL执行后返回了2条数据。
• 排查线索：比如“已核实数据库中存在两条手机号为138xxxx1234的用户记录，需检查phone字段的唯一索引是否被删除或失效”。
• 附加信息：比如当时的请求参数、数据库表的约束配置截图、相关代码片段（比如调用查询方法的代码）。

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