list解析 mybatis_mybatis-session.selectList源码分析

最新推荐文章于 2025-05-25 06:00:00 发布
原创 最新推荐文章于 2025-05-25 06:00:00 发布 · 358 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#list解析 mybatis

本文详细介绍了MyBatis的查询流程。首先构建SqlSessionFactory并获取sqlSession对象，接着创建执行器，默认返回SimpleExecutor。使用sqlSession的selectList方法查询时，会经过一系列步骤，如获取MappedStatement、创建缓存Key等，还涉及StatementHandler、ResultSetHandler等的处理。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

0.构建工厂：SqlSessionFactory 。 new SqlSessionFactoryBuilder.build(配置的xml文件)

获取sqlSession对象

//指定事务隔离级别

1. sqlMapper.openSession(TransactionIsolationLevel.SERIALIZABLE)

openSession->openSessionFromDataSource->DefaultSqlSession

openSession->getTransactionFactoryFromEnvironment

private SqlSession openSessionFromDataSource(ExecutorType execType, TransactionIsolationLevel level, boolean autoCommit) {

Transaction tx = null;

try {

final Environment environment = configuration.getEnvironment();

final TransactionFactory transactionFactory = getTransactionFactoryFromEnvironment(environment);

//通过事务工厂来产生一个事务

tx = transactionFactory.newTransaction(environment.getDataSource(), level, autoCommit);

//生成一个执行器(事务包含在执行器里)

final Executor executor = configuration.newExecutor(tx, execType);

//然后产生一个DefaultSqlSession

return new DefaultSqlSession(configuration, executor, autoCommit);

} catch (Exception e) {

//如果打开事务出错，则关闭它

closeTransaction(tx); // may have fetched a connection so lets call close()

throw ExceptionFactory.wrapException("Error opening session. Cause: " + e, e);

} finally {

//最后清空错误上下文

ErrorContext.instance().reset();

}

}

创建执行器 Executor (BatchExecutor,ReuseExecutor,SimpleExecutor,CachingExecutor)

默认是有缓存的，返回SimpleExecutor，并使用插件plugin,可以用来改变executor的行为

返回DefaultSqlSession;

使用sqlSession中对应的方法

2. session.selectList(指定的Mapper中的方法eg:selectAllAuthors)

selectList->executor.query->query

selectList-> configuration.getMappedStatement(statement)

public List selectList(String statement, Object parameter, RowBounds rowBounds) {

try {

//根据statement id找到对应的MappedStatement

MappedStatement ms = configuration.getMappedStatement(statement);

//转而用执行器来查询结果,注意这里传入的ResultHandler是null

return executor.query(ms, wrapCollection(parameter), rowBounds, Executor.NO_RESULT_HANDLER);

} catch (Exception e) {

throw ExceptionFactory.wrapException("Error querying database. Cause: " + e, e);

} finally {

ErrorContext.instance().reset();

}

}

public MappedStatement getMappedStatement(String id, boolean validateIncompleteStatements) {

//先构建所有语句，再返回语句

if (validateIncompleteStatements) {

buildAllStatements();

}

return mappedStatements.get(id);

}

public MappedStatement getMappedStatement(String id) {

return this.getMappedStatement(id, true);

}

query->ms.getBoundSql->sqlSource.getBoundSql

query->createCacheKey

query->query(ms, parameterObject, rowBounds, resultHandler, key, boundSql)

public List query(MappedStatement ms, Object parameterObject, RowBounds rowBounds, ResultHandler resultHandler) throws SQLException {

BoundSql boundSql = ms.getBoundSql(parameterObject);

//query时传入一个cachekey参数

CacheKey key = createCacheKey(ms, parameterObject, rowBounds, boundSql);

return query(ms, parameterObject, rowBounds, resultHandler, key, boundSql);

}

public BoundSql getBoundSql(Object parameterObject) {

//其实就是调用sqlSource.getBoundSql

BoundSql boundSql = sqlSource.getBoundSql(parameterObject);

//剩下的可以暂时忽略

List parameterMappings = boundSql.getParameterMappings();

if (parameterMappings == null || parameterMappings.isEmpty()) {

boundSql = new BoundSql(configuration, boundSql.getSql(), parameterMap.getParameterMappings(), parameterObject);

}

// check for nested result maps in parameter mappings (issue #30)

for (ParameterMapping pm : boundSql.getParameterMappings()) {

String rmId = pm.getResultMapId();

if (rmId != null) {

ResultMap rm = configuration.getResultMap(rmId);

if (rm != null) {

hasNestedResultMaps |= rm.hasNestedResultMaps();

}

}

}

return boundSql;

}

public BoundSql getBoundSql(Object parameterObject) {

return new BoundSql(configuration, sql, parameterMappings, parameterObject);

}

//创建缓存Key

public CacheKey createCacheKey(MappedStatement ms, Object parameterObject, RowBounds rowBounds, BoundSql boundSql) {

if (closed) {

throw new ExecutorException("Executor was closed.");

}

CacheKey cacheKey = new CacheKey();

//MyBatis 对于其 Key 的生成采取规则为：[mappedStementId + offset + limit + SQL + queryParams + environment]生成一个哈希码

cacheKey.update(ms.getId());

cacheKey.update(Integer.valueOf(rowBounds.getOffset()));

cacheKey.update(Integer.valueOf(rowBounds.getLimit()));

cacheKey.update(boundSql.getSql());

List parameterMappings = boundSql.getParameterMappings();

TypeHandlerRegistry typeHandlerRegistry = ms.getConfiguration().getTypeHandlerRegistry();

// mimic DefaultParameterHandler logic

//模仿DefaultParameterHandler的逻辑,不再重复，请参考DefaultParameterHandler

for (int i = 0; i < parameterMappings.size(); i++) {

ParameterMapping parameterMapping = parameterMappings.get(i);

if (parameterMapping.getMode() != ParameterMode.OUT) {

Object value;

String propertyName = parameterMapping.getProperty();

if (boundSql.hasAdditionalParameter(propertyName)) {

value = boundSql.getAdditionalParameter(propertyName);

} else if (parameterObject == null) {

value = null;

} else if (typeHandlerRegistry.hasTypeHandler(parameterObject.getClass())) {

value = parameterObject;

} else {

MetaObject metaObject = configuration.newMetaObject(parameterObject);

value = metaObject.getValue(propertyName);

}

cacheKey.update(value);

}

}

if (configuration.getEnvironment() != null) {

// issue #176

cacheKey.update(configuration.getEnvironment().getId());

}

return cacheKey;

}

query-> delegate. query(ms, parameterObject, rowBounds, resultHandler, key, boundSql)

public List query(MappedStatement ms, Object parameterObject, RowBounds rowBounds, ResultHandler resultHandler, CacheKey key, BoundSql boundSql)

throws SQLException {

Cache cache = ms.getCache();

//默认情况下是没有开启缓存的(二级缓存).要开启二级缓存,你需要在你的 SQL 映射文件中添加一行:

//简单的说，就是先查CacheKey，查不到再委托给实际的执行器去查

if (cache != null) {

flushCacheIfRequired(ms);

if (ms.isUseCache() && resultHandler == null) {

ensureNoOutParams(ms, parameterObject, boundSql);

@SuppressWarnings("unchecked")

List list = (List) tcm.getObject(cache, key);

if (list == null) {

list = delegate. query(ms, parameterObject, rowBounds, resultHandler, key, boundSql);

tcm.putObject(cache, key, list); // issue #578 and #116

}

return list;

}

}

return delegate. query(ms, parameterObject, rowBounds, resultHandler, key, boundSql);

}

query-> queryFromDatabase(ms, parameter, rowBounds, resultHandler, key, boundSql)

@SuppressWarnings("unchecked")

@Override

public List query(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, CacheKey key, BoundSql boundSql) throws SQLException {

ErrorContext.instance().resource(ms.getResource()).activity("executing a query").object(ms.getId());

//如果已经关闭，报错

if (closed) {

throw new ExecutorException("Executor was closed.");

}

//先清局部缓存，再查询.但仅查询堆栈为0，才清。为了处理递归调用

if (queryStack == 0 && ms.isFlushCacheRequired()) {

clearLocalCache();

}

List list;

try {

//加一,这样递归调用到上面的时候就不会再清局部缓存了

queryStack++;

//先根据cachekey从localCache去查

list = resultHandler == null ? (List) localCache.getObject(key) : null;

if (list != null) {

//若查到localCache缓存，处理localOutputParameterCache

handleLocallyCachedOutputParameters(ms, key, parameter, boundSql);

} else {

//从数据库查

list = queryFromDatabase(ms, parameter, rowBounds, resultHandler, key, boundSql);

}

} finally {

//清空堆栈

queryStack--;

}

if (queryStack == 0) {

//延迟加载队列中所有元素

for (DeferredLoad deferredLoad : deferredLoads) {

deferredLoad.load();

}

// issue #601

//清空延迟加载队列

deferredLoads.clear();

if (configuration.getLocalCacheScope() == LocalCacheScope.STATEMENT) {

// issue #482

//如果是STATEMENT，清本地缓存

clearLocalCache();

}

}

return list;

}

queryFromDatabase->doQuery

//从数据库查

private List queryFromDatabase(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, CacheKey key, BoundSql boundSql) throws SQLException {

List list;

//先向缓存中放入占位符？？？

localCache.putObject(key, EXECUTION_PLACEHOLDER);

try {

list = doQuery(ms, parameter, rowBounds, resultHandler, boundSql);

} finally {

//最后删除占位符

localCache.removeObject(key);

}

//加入缓存

localCache.putObject(key, list);

//如果是存储过程，OUT参数也加入缓存

if (ms.getStatementType() == StatementType.CALLABLE) {

localOutputParameterCache.putObject(key, parameter);

}

return list;

}

StatementHandler,

ResultSetHandler,

RoutingStatementHandler,

BaseStatementHandler,

PreparedStatementHandler

@Override

public List doQuery(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) throws SQLException {

Statement stmt = null;

try {

Configuration configuration = ms.getConfiguration();

//新建一个StatementHandler

//这里看到ResultHandler传入了

StatementHandler handler = configuration.newStatementHandler(wrapper, ms, parameter, rowBounds, resultHandler, boundSql);

//准备语句

stmt = prepareStatement(handler, ms.getStatementLog());

//StatementHandler.query

return handler.query(stmt, resultHandler);

} finally {

closeStatement(stmt);

}

}

Configuration

//创建结果集处理器

public ResultSetHandler newResultSetHandler(Executor executor, MappedStatement mappedStatement, RowBounds rowBounds, ParameterHandler parameterHandler,

ResultHandler resultHandler, BoundSql boundSql) {

//创建DefaultResultSetHandler(稍老一点的版本3.1是创建NestedResultSetHandler或者FastResultSetHandler)

ResultSetHandler resultSetHandler = new DefaultResultSetHandler(executor, mappedStatement, parameterHandler, resultHandler, boundSql, rowBounds);

//插件在这里插入

resultSetHandler = (ResultSetHandler) interceptorChain.pluginAll(resultSetHandler);

return resultSetHandler;

}

路由选择语句

public RoutingStatementHandler(Executor executor, MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) {

//根据语句类型，委派到不同的语句处理器(STATEMENT|PREPARED|CALLABLE)

switch (ms.getStatementType()) {

case STATEMENT:

delegate = new SimpleStatementHandler(executor, ms, parameter, rowBounds, resultHandler, boundSql);

break;

case PREPARED:

delegate = new PreparedStatementHandler(executor, ms, parameter, rowBounds, resultHandler, boundSql);

break;

case CALLABLE:

delegate = new CallableStatementHandler(executor, ms, parameter, rowBounds, resultHandler, boundSql);

break;

default:

throw new ExecutorException("Unknown statement type: " + ms.getStatementType());

}

}

BaseStatementHandler 语句处理类

//准备语句

@Override

public Statement prepare(Connection connection) throws SQLException {

ErrorContext.instance().sql(boundSql.getSql());

Statement statement = null;

try {

//实例化Statement

statement = instantiateStatement(connection);

//设置超时

setStatementTimeout(statement);

//设置读取条数

setFetchSize(statement);

return statement;

} catch (SQLException e) {

closeStatement(statement);

throw e;

} catch (Exception e) {

closeStatement(statement);

throw new ExecutorException("Error preparing statement. Cause: " + e, e);

}

}

PreparedStatementHandler

@Override

protected Statement instantiateStatement(Connection connection) throws SQLException {

//调用Connection.prepareStatement

String sql = boundSql.getSql();

if (mappedStatement.getKeyGenerator() instanceof Jdbc3KeyGenerator) {

String[] keyColumnNames = mappedStatement.getKeyColumns();

if (keyColumnNames == null) {

return connection.prepareStatement(sql, PreparedStatement.RETURN_GENERATED_KEYS);

} else {

return connection.prepareStatement(sql, keyColumnNames);queryFromDatabase

}

} else if (mappedStatement.getResultSetType() != null) {

return connection.prepareStatement(sql, mappedStatement.getResultSetType().getValue(), ResultSet.CONCUR_READ_ONLY);

} else {

return connection.prepareStatement(sql);

}

}

转载至链接:https://my.oschina.net/iioschina/blog/1859699

MyBatis参数详解+mybatis-config.xml配置文件
2201_76081438的博客
01-16 1507
在写配置文件的时候，可以指定包来起别名，这样写返回类型或者传参类型的时候可以简写。
（报错记录）mybatis整合mybatis-plus错误org.apache.ibatis.binding.BindingException: Invalid bound statement
eggplantttttt的博客
03-21 1717
org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.mindskip.xzs.repository.SubjectMapper.page at com.baomidou.mybatisplus.core.override.PageMapperMethod$SqlCommand.<init>(PageMapperMethod.java:261) ~[mybatis-plus-co
MyBatisPlus条件构造器带条件查询selectList使用示例代码
04-22
MyBatisPlus条件构造器带条件查询selectList使用示例代码
详解Mybatis中SqlSession接口中的selectList方法
热门推荐
BUG粉碎机
10-06 3万+
1.SqlSession简介 SqlSession是mybatis持久层框架提供的接口，该接口中包含了大量的CRUD操作方法（既增删改查方法）。 2.selectList方法 selectList方法是用于查询的方法，该方法具有多态性，如图所示（打开mybatis的SqlSession接口所得到） 3.selectList方法简介 该方法一共有三种不同的调用方式： List selectList(String var1); 第一种为单个参数的构造函数，参数为配置文件的mapper标签的namespac
Mybatis中SqlSession接口中的selectList方法
qq_62571013的博客
04-14 2151
Mybatis中SqlSession接口中的selectList方法
Mybatis源码分析-selectList源码分析
瑞文のBlog
01-26 1804
文章目录一、开篇二、源码分析1.selectList（）2.CachingExecutor3、createCacheKey1）为什么CachingExecutor要调用SimpleExecutor的方法去创建缓存key呢?4、创建好缓存key之后:query查询二级缓存5、如果二级缓存为空继续走查询query查询一级缓存6、查询一级缓存为空queryFromDatabase查询数据库三、演示四、总结 一、开篇 在我们分析Executor的时候最后一步就是查询我们的数据库 本篇就是去深究一下Mybatis
mybatis-session.selectList源码分析
weixin_34242509的博客
07-19 1117
2019独角兽企业重金招聘Python工程师标准>>> ...
mybatis-demo3-crud.zip
08-03
MyBatis是一个优秀的Java持久层框架，它支持定制化SQL、存储过程以及高级映射。在本示例"Mybatis-demo3-crud.zip"中，我们将深入探讨MyBatis如何进行单表查询操作，这是数据库操作中最基本也最常用的功能。 首先，...
关于mybatis配置文件mybatis-config.xml导入外部资源错误
bi1919138648的博客
10-07 347
如果你不需要过滤操作，或者你的配置文件中没有占位符， 你可以将 <filtering> 设置为 false 或省略它，以告诉 Maven 不执行过滤操作。意味着 Maven 会对这些资源文件执行过滤，也就是在构建过程中替换文件中的占位符。原因是pom.xml中过滤资源文件配置，把。
mybatis-cursor-demo.zip
02-22
使用Cursor的关键在于调用`selectList`方法时传入`ExecutorType.SIMPLE`或`ExecutorType.BATCH`，并确保返回值类型是`List`的子类，比如`ArrayList`或`LinkedList`，这样MyBatis就会自动启用Cursor模式。 以下是一...
详解Mybatis中的select方法
08-27
主要介绍了Mybatis的select方法,通过代码给大家详细介绍了selectByExample方法，selectById方法，需要的朋友可以参考下
mybatis selectList方法实现原理
清风不灭的博客
01-28 9324
mybatis在使用代理dao的方式实现增删改查时做了什么事呢？ 两件事：1、创建代理对象；2、在代理对象中调用selectList()方法。 下面分析一下selectList()方法执行的原理。 selectList方法将在getMapper中被调用：https://blog.csdn.net/weixin_40391011/article/details/104097602 ...
MyBatis源码的学习（15）---sqlSession.selectList方法
itw_zhangzx02的博客
12-29 7276
sqlSession一共俩个实现类，我们这里分析默认的DefaultSqlSession类 public <E> List<E> selectList(String statement, Object parameter, RowBounds rowBounds) { try { //ms对象代表我们的xml中的一条sql。例如：<select...
第八篇：SqlSession.selectList调用过程
zxc_user的博客
07-15 2275
mybatis.selectList方法分析
mybatis：selectList/selectOne原理
учёба
05-25 914
首先，我们需要知道一些mybatis的基本原料和流程，见。
15.MyBatis学习--映射文件_select_返回List
Adela0916的博客
12-27 286
若select返回的是一个List集合，则resultType要写集合中元素的类型。 示例： dao接口代码：查询所有的员工信息 public List<Employee> getAllEmps(); sql映射文件代码： <!-- resultType: 如果返回的是一个集合，要写集合中元素的类型 --> <select id="getAllEmps" resultType="com.fzl.mybatis.bean.Employee">
MyBatis（五）select返回list数据
dengxie0831的博客
04-15 1122
（1）接口中编写方法 public List<Emp> getEmps(String lastName); （2）编写Mapper文件 　　<select id="getEmps" resultType="com.eu.bean.Emp"> select id,last_name lastName,gender geder,em...
java select list_MyBatis三个查询方法_selectList_selectOne_selectMap
weixin_39790877的博客
02-19 1355
mybatis-cfg.xml的配置：/p>PUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd">db.properties:jdbc.driver=com.mysql.jdbc.Driverjdbc.url=jdbc:mysql://192.168.5.129:...
关于java myBatis selectList 问题
wang735164515的博客
03-08 4623
今天碰到一个问题，就是session.selectList("ndb.getVipConfig"); 总是出错。 报错数据为： org.apache.ibatis.exceptions.PersistenceException:  ### Error querying database.  Cause: org.apache.ibatis.reflection.Reflec
org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found: 2 at org.apache.ibatis.session.defaults.DefaultSqlSession.selectOne(DefaultSqlSession.java:81) ~[mybatis-3.5.13.jar:3.5.13] at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[na:1.8.0_351] at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) ~[na:1.8.0_351] at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[na:1.8.0_351] at java.lang.reflect.Method.invoke(Method.java:498) ~[na:1.8.0_351] at org.mybatis.spring.SqlSessionTemplate$SqlSessionInterceptor.invoke(SqlSessionTemplate.java:425) ~[mybatis-spring-2
最新发布
07-21
<think>我们正在解决MyBatis中`selectOne`方法返回多个结果时抛出的`TooManyResultsException`问题。用户期望每次调用`selectOne`时只返回一个结果，但实际查询返回了两个或更多结果，导致异常。 ### 问题分析 1. **根本原因**：`selectOne`方法要求查询结果必须为0或1条记录。当SQL查询返回多于1条记录时，MyBatis会抛出`org.apache.ibatis.exceptions.TooManyResultsException`。 2. **常见场景**： - 查询条件不够严格（如未使用唯一索引字段） - 数据库数据重复（违反唯一约束） - SQL语句错误（如忘记写WHERE条件） ### 解决方案 #### 方法一：确保查询条件唯一性（推荐） 修改SQL语句，确保查询条件能唯一确定一条记录： ```xml <select id="selectUserById" resultType="User"> SELECT * FROM user WHERE id = #{id} <!-- id为主键，确保唯一 --> </select> ``` #### 方法二：使用LIMIT限制结果集 在无法修改数据唯一性的情况下，强制限制返回结果数量： ```xml <select id="selectOneUserByName" resultType="User"> SELECT * FROM user WHERE name = #{name} LIMIT 1 <!-- 仅返回第一条 --> </select> ``` > 注意：此方法可能返回非预期数据，需谨慎使用。 #### 方法三：修改DAO层方法签名 如果业务逻辑允许返回多个结果，应改用`selectList`方法： ```java // 接口方法修改 List<User> selectUsersByName(String name); ``` 对应XML： ```xml <select id="selectUsersByName" resultType="User"> SELECT * FROM user WHERE name = #{name} </select> ``` #### 方法四：数据库层面添加约束 若数据重复是设计缺陷，应通过数据库约束解决： ```sql ALTER TABLE user ADD UNIQUE (email); -- 为email字段添加唯一约束 ``` ### 错误示例分析 ```java User user = sqlSession.selectOne("selectUserByName", "Alice"); // 当有多个Alice时抛出异常 ``` 修正方案： 1. 精确查询条件（如同时使用姓名+手机号） 2. 捕获异常并处理： ```java try { return sqlSession.selectOne("selectUserByName", "Alice"); } catch (TooManyResultsException e) { logger.warn("找到多个同名用户，返回第一条"); return sqlSession.selectList("selectUserByName", "Alice").get(0); } ``` ### 预防措施 1. **单元测试验证**： ```java @Test public void testSelectOne() { User user = userDao.selectById(1); // 唯一查询 assertEquals(1, user.getId()); // 验证重复数据场景 assertThrows(TooManyResultsException.class, () -> { userDao.selectByName("Alice"); }); } ``` 2. **SQL审核**：使用MyBatis拦截器检查返回结果数量： ```java @Intercepts(@Signature(type = ResultSetHandler.class, method = "handleResultSets", args = {Statement.class})) public class ResultSizeInterceptor implements Interceptor { @Override public Object intercept(Invocation invocation) throws Throwable { // 检查方法是否为selectOne，若是则验证结果数量 // ... } } ``` ### 高级技巧：使用ResultHandler自定义处理 ```java sqlSession.select("selectUsersByName", param, new ResultHandler<User>() { @Override public void handleResult(ResultContext<? extends User> context) { User user = context.getResultObject(); // 自定义处理逻辑，例如只取第一条 if (context.getResultCount() > 1) { context.stop(); // 停止继续获取结果 throw new TooManyResultsException("期望1条，实际多条"); } } }); ``` ### 总结处理流程 ```mermaid graph TD A[调用selectOne方法] --> B{结果数量检查} B -->|0条| C[返回null] B -->|1条| D[返回对象] B -->|多条| E[抛出TooManyResultsException] E --> F[解决方案] F --> G[修改SQL条件] F --> H[使用LIMIT 1] F --> I[改用selectList] ``` --- ### 相关问题 1. MyBatis中`selectList`和`selectOne`的性能差异是什么？ 2. 如何全局拦截MyBatis异常进行统一处理？ 3. MyBatis结果集映射有哪些最佳实践？ 4. 在Spring Boot中如何配置MyBatis的日志输出？ > 通过严格约束查询条件或显式限制结果数量，可有效解决`TooManyResultsException`问题。在业务设计阶段应优先考虑数据唯一性约束[^1]。</think>### 解决 MyBatis `selectOne()` 返回多个结果的问题 当使用 MyBatis 的 `selectOne()` 方法查询时，如果 SQL 返回了多个结果，会抛出 `TooManyResultsException` 异常。以下是完整的解决方案： --- #### 一、问题根本原因 `selectOne()` 方法要求查询结果**必须为 0 或 1 条记录**。当数据库中存在多条匹配记录时，MyBatis 会抛出： ```java org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found: 2 ``` --- #### 二、解决方案 ##### 1. 确保查询条件唯一性（推荐） ```xml <!-- UserMapper.xml --> <select id="findUserByUniqueKey" resultType="User"> SELECT * FROM users WHERE unique_code = #{code} <!-- 使用唯一性字段 --> </select> ``` ```java // 调用方式 User user = userMapper.findUserByUniqueKey("A123"); ``` ##### 2. 添加 LIMIT 限制 ```xml <select id="findFirstUserByName" resultType="User"> SELECT * FROM users WHERE name = #{name} LIMIT 1 <!-- 强制只返回一条 --> </select> ``` ##### 3. 改用 `selectList()` 方法 ```java // Mapper 接口 List<User> findUsersByName(String name); // 调用方式 List<User> users = userMapper.findUsersByName("Alice"); User firstUser = users.isEmpty() ? null : users.get(0); ``` ##### 4. 数据库层去重 ```sql SELECT DISTINCT * FROM users WHERE department = 'IT' -- 去重查询 ``` ##### 5. 添加聚合函数 ```xml <select id="countUsers" resultType="int"> SELECT COUNT(*) FROM users WHERE role = #{role} </select> ``` --- #### 三、错误使用场景分析 ```java // ❌ 错误示例：非唯一字段查询 User user = sqlSession.selectOne("findUserByName", "Alice"); // ✅ 正确修改： // 方案1：改用 selectList List<User> users = sqlSession.selectList("findUserByName", "Alice"); // 方案2：增加唯一性条件 User user = sqlSession.selectOne("findUserByEmail", "alice@example.com"); ``` --- #### 四、预防措施 1. **数据库设计**： - 为主表添加主键约束 - 为业务唯一字段添加 `UNIQUE` 约束 ```sql ALTER TABLE users ADD UNIQUE (email); ``` 2. **MyBatis 拦截器监控**： ```java @Intercepts(@Signature(type = Executor.class, method = "query", args = { MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class })) public class ResultSizeInterceptor implements Interceptor { @Override public Object intercept(Invocation invocation) throws Throwable { Object result = invocation.proceed(); if (result instanceof List && ((List<?>) result).size() > 1) { log.warn("⚠️ 查询返回多条结果: {}", invocation.getArgs()[0]); } return result; } } ``` --- #### 五、处理流程 ```mermaid graph TD A[调用 selectOne] --> B{结果数量检查} B -->|0条| C[返回null] B -->|1条| D[返回对象] B -->|多条| E[抛出TooManyResultsException] E --> F[解决方案] F --> G[修改查询条件] F --> H[使用LIMIT 1] F --> I[改用selectList] ``` --- ### 相关问题 1. MyBatis 中 `selectList` 和 `selectOne` 的性能差异是什么？ 2. 如何配置 MyBatis 拦截器进行 SQL 监控？ 3. MyBatis 结果集映射有哪些最佳实践？ 4. 在 Spring Boot 中如何全局处理 MyBatis 异常？ > 通过确保查询条件的唯一性或显式限制结果数量，可彻底解决此问题。在设计阶段优先考虑数据库约束是根本解决方案[^1]。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值