HTTP 500错误排查：查询结果预期1条实际返回2条

我来帮你拆解这个问题——从错误信息和你贴的代码来看，触发500错误的核心原因非常明确：你的数据库里存在多条categoryvocabularyid相同的记录，而你用的jdbcTemplate.queryForObject()方法严格要求查询结果必须恰好是1条，多了或少了都会直接抛出异常，这个未被捕获的异常最终就转化成了HTTP 500错误。

问题根源拆解 #

• 数据不符合业务预期：你的SQL是根据categoryvocabularyid查询词汇表，但这个字段没有设置唯一约束，导致同一个categoryvocabularyid对应了多条词汇记录，打破了代码“查1条”的假设。
• API选型不匹配：queryForObject()的设计目标就是返回唯一一条结果，如果结果集为空或者超过1条，会直接抛出IncorrectResultSizeDataAccessException，而你没有在代码中处理这个异常，它就会向上传递触发服务器内部错误。

针对性解决方案 #

根据你的业务逻辑，分两种场景处理：

场景1：业务要求一个categoryvocabularyid只能对应1条记录 #

如果你的业务规则里，分类ID和词汇是一对一的关系，那需要从两个层面修复：

1. 数据库层面：给vocabulary表的categoryvocabularyid字段添加唯一约束，从根源避免重复数据：

   ALTER TABLE vocabulary ADD CONSTRAINT uk_vocabulary_category_id UNIQUE (categoryvocabularyid);
   

2. 数据清理：手动清理现有重复数据，保留一条正确的记录，确保后续查询只会返回1条结果。

场景2：业务允许一个categoryvocabularyid对应多条记录 #

如果业务逻辑本来就支持一个分类下有多条词汇，那需要修改Dao层的方法，改用支持返回多条结果的API：

• 修改Dao层代码：

  public List<Vocabulary> getItems(int categoryvocabularyid) { 
      String sql = "SELECT * FROM vocabulary WHERE categoryvocabularyid = ?"; 
      return jdbcTemplate.query(sql, new Object[]{categoryvocabularyid}, new BeanPropertyRowMapper<Vocabulary>(Vocabulary.class)); 
  }
  

• 调整Controller层逻辑，处理列表数据：

  @RequestMapping("/public/vocabulary/{id}") 
  public String readedit(@PathVariable("id") int categoryvocabularyid, ModelMap modelMap){ 
      List<Vocabulary> vocalList = vocaburalysDao.getItems(categoryvocabularyid);
      // 根据业务需求处理：比如取第一条，或者把整个列表传给前端
      if (!vocalList.isEmpty()) {
          modelMap.addAttribute("vocal", vocalList.get(0));
      } else {
          // 处理无数据的情况，比如返回提示或跳转到404页面
          modelMap.addAttribute("errorMsg", "未找到对应分类的词汇");
      }
      return...
  }
  

额外优化：添加异常捕获 #

不管哪种场景，都建议在代码中捕获异常，避免直接返回500错误给前端，提升用户体验：

@RequestMapping("/public/vocabulary/{id}") 
public String readedit(@PathVariable("id") int categoryvocabularyid, ModelMap modelMap){ 
    try {
        modelMap.addAttribute("vocal", vocaburalysDao.getItem(categoryvocabularyid)); 
    } catch (IncorrectResultSizeDataAccessException e) {
        modelMap.addAttribute("errorMsg", "查询到多条匹配数据，请检查分类ID");
        return "error/query_error"; // 返回自定义错误页面
    }
    return...
}

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