快捷導(dǎo)航

解決java報錯:使用mybatis?plus查詢一個只返回一條數(shù)據(jù)的sql,卻報錯返回了1000多條問題

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

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

今天遇到一個問題

系統(tǒng)線上問題

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

乍一看，感覺太不可思議了

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

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

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

但是它里面并沒有那么智能，就像它的名字selectOne一樣，你想查詢一條記錄，那么我就幫你查一條記錄，如果有多條記錄，那么我報錯也是合情合理的吧，畢竟你只查一條記錄，也沒有說要查哪一條是吧。

實際上

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

/**
     * 根據(jù) entity 條件，查詢一條記錄，現(xiàn)在會根據(jù){@code throwEx}參數(shù)判斷是否拋出異常，如果為false就直接返回一條數(shù)據(jù)
     * <p>查詢一條記錄，例如 qw.last("limit 1") 限制取一條記錄, 注意：多條數(shù)據(jù)會報異常</p>
     *
     * @param queryWrapper 實體對象封裝操作類（可以為 null）
     * @param throwEx      boolean 參數(shù)，為true如果存在多個結(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;
    }
  }

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