快捷導(dǎo)航

解決java報(bào)錯(cuò):使用mybatis?plus查詢一個(gè)只返回一條數(shù)據(jù)的sql,卻報(bào)錯(cuò)返回了1000多條問(wèn)題

更新時(shí)間：2026年04月09日 16:41:38 作者：svygh123

文章解釋了一個(gè)系統(tǒng)問(wèn)題,盡管SQL寫(xiě)了limit?1且MyBatis的debug日志顯示total為1,但仍返回了1805條數(shù)據(jù),原因是selectOne方法只查詢一條記錄,若有多條則報(bào)錯(cuò),而非智能篩選,文章還分析了MyBatisPlus和MyBatis中selectOne方法的不同實(shí)現(xiàn)

今天遇到一個(gè)問(wèn)題

系統(tǒng)線上問(wèn)題

經(jīng)常出現(xiàn)這樣的問(wèn)題，剛重啟系統(tǒng)時(shí)不報(bào)錯(cuò)了，可是運(yùn)行一段時(shí)間又會(huì)出現(xiàn)。
sql已經(jīng)寫(xiě)了limit 1，mybatis的debug日志也返回total為1，可是卻報(bào)錯(cuò)返回了1805條數(shù)據(jù)

乍一看，感覺(jué)太不可思議了

其實(shí)還是被默認(rèn)的東西給坑到了，也不能說(shuō)是坑，就是不理解里面的原理，拿來(lái)就用，以為是這個(gè)功能，其實(shí)還有隱藏的內(nèi)幕在里面。

這個(gè)里面的東西就是selectOne方法，這個(gè)方法，我們以為的查詢方式是這樣的：

select code,username,sex,age,birth from t_user where code=#[code] limit 1

但是它里面并沒(méi)有那么智能，就像它的名字selectOne一樣，你想查詢一條記錄，那么我就幫你查一條記錄，如果有多條記錄，那么我報(bào)錯(cuò)也是合情合理的吧，畢竟你只查一條記錄，也沒(méi)有說(shuō)要查哪一條是吧。

實(shí)際上

MyBatis Plus（com.baomidou.mybatisplus.core.mapper.BaseMapper.selectOne）是這樣的：

/**
     * 根據(jù) entity 條件，查詢一條記錄，現(xiàn)在會(huì)根據(jù){@code throwEx}參數(shù)判斷是否拋出異常，如果為false就直接返回一條數(shù)據(jù)
     * <p>查詢一條記錄，例如 qw.last("limit 1") 限制取一條記錄, 注意：多條數(shù)據(jù)會(huì)報(bào)異常</p>
     *
     * @param queryWrapper 實(shí)體對(duì)象封裝操作類（可以為 null）
     * @param throwEx      boolean 參數(shù)，為true如果存在多個(gè)結(jié)果直接拋出異常
     */
    default T selectOne(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper, boolean throwEx) {
        List<T> list = this.selectList(queryWrapper);
        // 抄自 DefaultSqlSession#selectOne
        int size = list.size();
        if (size == 1) {
            return list.get(0);
        } else if (size > 1) {
            if (throwEx) {
                throw new TooManyResultsException("Expected one result (or null) to be returned by selectOne(), but found: " + list.size());
            }
            return list.get(0);
        }
        return null;
    }

而MyBatis（org.apache.ibatis.session.defaults.DefaultSqlSession.selectOne）是這樣的：

@Override
  public <T> T selectOne(String statement, Object parameter) {
    // Popular vote was to return null on 0 results and throw exception on too many.
    List<T> list = this.selectList(statement, parameter);
    if (list.size() == 1) {
      return list.get(0);
    }
    if (list.size() > 1) {
      throw new TooManyResultsException(
          "Expected one result (or null) to be returned by selectOne(), but found: " + list.size());
    } else {
      return null;
    }
  }

是吧，拿來(lái)的東西固然好，但是也要花點(diǎn)時(shí)間學(xué)習(xí)里面的精髓。