org.springframework.dao.EmptyResultDataAccessException: Incorrect result size: expected 1, actual 0报错

<think>好的，我现在需要解决用户提到的Spring框架中的EmptyResultDataAccessException异常，具体是"Incorrect result size: expected 1, actual 0"。首先，我得回忆一下这个异常通常发生的原因。根据用户提供的引用资料，比如引用[2]和引用[3]，这个异常在使用JdbcTemplate的queryForObject方法时，当查询结果没有找到任何记录（实际0条），但方法期望返回1条记录时就会抛出。 接下来，我应该考虑可能的解决方案。用户提供的引用中已经提到了一些方法，比如捕获异常并返回null（引用[4]），或者使用query方法代替queryForObject。我需要整理这些方法，并可能补充其他可行的解决方案。比如，检查SQL语句是否正确，确保查询条件能正确匹配到记录，或者在查询前先验证数据是否存在。 另外，还需要考虑不同的使用场景。例如，如果用户确实期望有时没有结果，是否应该返回Optional或者空集合，而不是强制要求必须有结果。或者使用Java 8的Optional来处理可能的空结果，这样更符合现代编程实践。 还要检查数据库中的数据，确保查询的条件字段在数据库中存在对应的记录。比如，如果根据username查询，但数据库中没有该username的记录，就会导致这个问题。这时候可能需要添加数据校验，或者在调用查询方法之前进行存在性检查。 此外，可能需要考虑使用其他JdbcTemplate的方法，比如queryForList，如果允许返回多个结果的话，或者使用query并处理结果集，检查结果的数量是否符合预期，再进行处理。同时，也可以考虑在服务层进行逻辑处理，避免直接调用可能抛出异常的方法。 最后，总结这些解决方案，按优先级或推荐程度排序，帮助用户逐步解决问题。需要确保回答结构清晰，分点说明，并引用提供的资料来支持每个解决方案的有效性。</think>### 解决方案：EmptyResultDataAccessException异常处理 当使用Spring的`JdbcTemplate.queryForObject`方法时，如果查询结果为空（实际返回0条记录）或返回多条记录（实际返回>1条），就会抛出`EmptyResultDataAccessException`[^2][^3]。以下是具体解决方案： --- #### 方法1：改用`query`方法处理空结果 通过`query`方法获取结果列表，手动处理空结果： ```java public User getUserByUsername(String username) { String sql = "SELECT * FROM users WHERE username = ?"; List<User> users = jdbcTemplate.query(sql, new Object[]{username}, new BeanPropertyRowMapper<>(User.class)); return users.isEmpty() ? null : users.get(0); //返回第一个结果或null } ``` - **优势**：避免直接抛出异常，兼容空结果场景[^4]。 - **注意**：需明确业务逻辑是否需要允许空结果。 --- #### 方法2：捕获异常并返回默认值 显式捕获异常并处理： ```java public User findUser(String username) { try { return jdbcTemplate.queryForObject("SELECT * FROM users WHERE username=?", new BeanPropertyRowMapper<>(User.class), username); } catch (EmptyResultDataAccessException e) { return null; //或自定义默认值 } } ``` - **适用场景**：明确预期结果可能不存在，且需保持代码简洁性。 --- #### 方法3：使用Java 8的`Optional`包装结果 ```java public Optional<User> findUserSafe(String username) { List<User> users = jdbcTemplate.query( "SELECT * FROM users WHERE username=?", new BeanPropertyRowMapper<>(User.class), username); return users.stream().findFirst(); } ``` - **优势**：强制调用方处理空值，符合函数式编程规范。 --- #### 方法4：验证查询条件有效性 在执行查询前检查参数合法性： ```java public User getUser(String username) { if (StringUtils.isEmpty(username)) { throw new IllegalArgumentException("用户名不能为空"); } // 继续执行查询... } ``` - **作用**：避免无效查询条件导致异常。 --- #### 方法5：使用聚合函数确保单值返回 若查询目标是统计值（如数量），改用聚合函数： ```java int count = jdbcTemplate.queryForObject( "SELECT COUNT(*) FROM users WHERE username=?", Integer.class, username); ``` - **适用场景**：统计操作天然返回单值，避免异常[^1]。 --- #### 根本原因分析 此异常源于`queryForObject`的严格设计：要求结果集必须**恰好一行一列**。若实际数据与预期不符（如0行或多行），Spring会抛出异常以提示数据不一致问题。 ---