一、面試現(xiàn)場(chǎng)一個(gè)讓無(wú)數(shù)人卡殼的問(wèn)題1.1 面試對(duì)話還原面試官翻了翻簡(jiǎn)歷看到熟練掌握 MyBatis抬起頭問(wèn)了一句你說(shuō)你熟悉 MyBatis那我問(wèn)你你的UserMapper只是一個(gè)接口沒(méi)有實(shí)現(xiàn)類為什么調(diào)用userMapper.selectById(1L)就能執(zhí)行 SQL 呢候選人開(kāi)始回憶因?yàn)椤璏yBatis 用了動(dòng)態(tài)代理面試官追問(wèn)什么動(dòng)態(tài)代理JDK 還是 CGLIB代理對(duì)象是什么時(shí)候生成的selectById又是怎么映射到 XML 里的 SQL 的候選人這個(gè)……應(yīng)該是啟動(dòng)的時(shí)候掃描 XML 吧……面試官那你說(shuō)說(shuō)如果 Mapper 接口有兩個(gè)同名方法MyBatis 能區(qū)分嗎如果 XML 的 namespace 寫(xiě)錯(cuò)了會(huì)怎樣到這里很多候選人已經(jīng)答不上來(lái)了。這個(gè)問(wèn)題看似簡(jiǎn)單實(shí)則是一道分水嶺題——它能一次性考察你對(duì)JDK 動(dòng)態(tài)代理、MyBatis 初始化流程、MapperRegistry 注冊(cè)機(jī)制、MapperProxy 調(diào)用鏈、MapperMethod 方法映射、SqlSession 執(zhí)行流程、Executor 執(zhí)行器體系的理解深度。1.2 為什么面試官愛(ài)問(wèn)這道題這道題的價(jià)值在于看你是不是只會(huì)用很多人用 MyBatis 幾年但從來(lái)沒(méi)想過(guò)接口為什么能執(zhí)行 SQL看你能不能講清原理從接口到代理從代理到 SQL這條鏈路涉及多個(gè)核心組件看你能不能延伸到實(shí)戰(zhàn)Mapper 重載為什么不支持、namespace 寫(xiě)錯(cuò)會(huì)怎樣、二級(jí)緩存與代理的關(guān)系看你能不能對(duì)比技術(shù)和 Spring Data JPA 的接口自動(dòng)實(shí)現(xiàn)有什么區(qū)別本文結(jié)構(gòu)一句話結(jié)論從使用場(chǎng)景到實(shí)現(xiàn)原理JDK 動(dòng)態(tài)代理基礎(chǔ)MyBatis 初始化流程Mapper 是怎么被注冊(cè)的MapperProxyFactory代理工廠MapperProxy方法調(diào)用的攔截器MapperMethod方法到 SQL 的映射SqlSession 與 ExecutorSQL 真正執(zhí)行的地方為什么 Mapper 接口不支持方法重載實(shí)戰(zhàn)問(wèn)題排查高頻追問(wèn)與回答模板總結(jié)二、一句話結(jié)論MyBatis 在啟動(dòng)時(shí)通過(guò) JDK 動(dòng)態(tài)代理為每個(gè) Mapper 接口生成了一個(gè)代理對(duì)象。你調(diào)用的userMapper.selectById(1L)實(shí)際上調(diào)用的是這個(gè)代理對(duì)象的invoke()方法。代理對(duì)象內(nèi)部根據(jù)接口全限定名 方法名找到對(duì)應(yīng)的 SQL 語(yǔ)句MappedStatement然后交給 SqlSession 執(zhí)行。一句話總結(jié)接口不能執(zhí)行 SQL能執(zhí)行 SQL 的是 MyBatis 生成的代理對(duì)象。三、從使用場(chǎng)景到實(shí)現(xiàn)原理3.1 一個(gè)最簡(jiǎn)單的 MyBatis 使用例子javapublic interface UserMapper { User selectById(Long id); }xmlmapper namespacecom.example.mapper.UserMapper select idselectById resultTypecom.example.entity.User SELECT * FROM user WHERE id #{id} /select /mapperjavaSqlSession sqlSession sqlSessionFactory.openSession(); UserMapper userMapper sqlSession.getMapper(UserMapper.class); User user userMapper.selectById(1L);疑惑UserMapper只是一個(gè)接口沒(méi)有實(shí)現(xiàn)類userMapper.selectById(1L)卻可以執(zhí)行 SQL。這是為什么3.2 核心答案動(dòng)態(tài)代理sqlSession.getMapper(UserMapper.class)返回的并不是UserMapper的某個(gè)實(shí)現(xiàn)類而是MyBatis 通過(guò) JDK 動(dòng)態(tài)代理生成的一個(gè)代理對(duì)象。這個(gè)代理對(duì)象實(shí)現(xiàn)了UserMapper接口因此可以賦值給UserMapper類型的變量。但它所有的方法調(diào)用都會(huì)被攔截到MapperProxy.invoke()方法中在invoke()里完成找到 SQL、執(zhí)行 SQL、返回結(jié)果的全流程。四、JDK 動(dòng)態(tài)代理基礎(chǔ)4.1 什么是 JDK 動(dòng)態(tài)代理JDK 動(dòng)態(tài)代理是 Java 原生提供的代理機(jī)制位于java.lang.reflect包下。它要求目標(biāo)對(duì)象必須實(shí)現(xiàn)接口這是 JDK 動(dòng)態(tài)代理的硬性要求代理對(duì)象與目標(biāo)對(duì)象實(shí)現(xiàn)相同的接口方法調(diào)用會(huì)被InvocationHandler.invoke()攔截4.2 JDK 動(dòng)態(tài)代理的核心 APIjavapublic interface InvocationHandler { Object invoke(Object proxy, Method method, Object[] args) throws Throwable; } public static Object newProxyInstance( ClassLoader loader, Class?[] interfaces, InvocationHandler h)4.3 一個(gè)簡(jiǎn)單的 JDK 動(dòng)態(tài)代理示例javapublic interface UserService { void sayHello(String name); } public class UserServiceImpl implements UserService { Override public void sayHello(String name) { System.out.println(Hello, name); } } public class MyInvocationHandler implements InvocationHandler { private Object target; public MyInvocationHandler(Object target) { this.target target; } Override public Object invoke(Object proxy, Method method, Object[] args) throws Throwable { System.out.println(before method: method.getName()); Object result method.invoke(target, args); System.out.println(after method: method.getName()); return result; } } public class Main { public static void main(String[] args) { UserService target new UserServiceImpl(); UserService proxy (UserService) Proxy.newProxyInstance( target.getClass().getClassLoader(), new Class?[]{UserService.class}, new MyInvocationHandler(target) ); proxy.sayHello(張三); } }輸出textbefore method: sayHello Hello, 張三 after method: sayHello關(guān)鍵點(diǎn)代理對(duì)象實(shí)現(xiàn)了UserService接口但它的所有方法調(diào)用都會(huì)先進(jìn)入InvocationHandler.invoke()。4.4 MyBatis 是怎么用這套機(jī)制的MyBatis 生成的 Mapper 代理和上面的例子類似但有兩點(diǎn)不同目標(biāo)對(duì)象不存在MyBatis 沒(méi)有為接口寫(xiě)實(shí)現(xiàn)類所以代理對(duì)象不需要委托給 target攔截邏輯不同MapperProxy.invoke()不是簡(jiǎn)單地前后加日志而是根據(jù)方法名找到 SQL 并執(zhí)行換句話說(shuō)MyBatis 的代理對(duì)象就是一個(gè)空殼它唯一的作用就是把接口方法調(diào)用轉(zhuǎn)換成 SQL 執(zhí)行。五、MyBatis 初始化流程Mapper 是怎么被注冊(cè)的5.1 從 SqlSessionFactory 的構(gòu)建說(shuō)起MyBatis 啟動(dòng)時(shí)會(huì)解析mybatis-config.xml和所有 Mapper XML構(gòu)建一個(gè)Configuration對(duì)象并封裝成SqlSessionFactory。核心流程textSqlSessionFactoryBuilder.build() → XMLConfigBuilder.parse() → Configuration 初始化 → mapperElement() 解析 mappers 標(biāo)簽 → MapperRegistry.addMapper()5.2 解析 mappers 標(biāo)簽mybatis-config.xml中配置xmlmappers mapper resourcemapper/UserMapper.xml/ package namecom.example.mapper/ /mappersXMLConfigBuilder.mapperElement()會(huì)遍歷這些配置逐一處理。以package為例它會(huì)掃描包下所有.class文件找出所有接口不是類、不是枚舉、不是注解為每個(gè)接口調(diào)用configuration.addMapper(interface)5.3 MapperRegistry接口注冊(cè)中心Configuration內(nèi)部維護(hù)了一個(gè)MapperRegistryjavapublic class MapperRegistry { private final Configuration config; private final MapClass?, MapperProxyFactory? knownMappers new HashMap(); public T void addMapper(ClassT type) { if (type.isInterface()) { if (hasMapper(type)) { throw new BindingException(Type type is already known to the MapperRegistry.); } boolean loadCompleted false; try { // 核心為接口創(chuàng)建 MapperProxyFactory knownMappers.put(type, new MapperProxyFactory(type)); // 解析 XML如果存在同名的 .xml 文件 MapperAnnotationBuilder parser new MapperAnnotationBuilder(config, type); parser.parse(); loadCompleted true; } finally { if (!loadCompleted) { knownMappers.remove(type); } } } } }關(guān)鍵knownMappers的 key 是接口的Class對(duì)象value 是MapperProxyFactory只有接口才會(huì)被注冊(cè)type.isInterface()注冊(cè)后會(huì)立即解析注解和 XML把MappedStatement放進(jìn)Configuration5.4 XML 的 namespace 必須等于接口全限定名這一點(diǎn)非常關(guān)鍵MyBatis 在解析 XML 時(shí)會(huì)讀取mapper namespace...然后嘗試通過(guò)Resources.classForName(namespace)加載這個(gè)類如果成功調(diào)用configuration.addMapper(namespaceClass)如果失敗比如 namespace 拼寫(xiě)錯(cuò)誤不會(huì)拋出異常但Mapper 接口和 XML 就沒(méi)有關(guān)聯(lián)這就是為什么很多初學(xué)者遇到Invalid bound statement (not found)報(bào)錯(cuò)——十有八九是 namespace 寫(xiě)錯(cuò)了。六、MapperProxyFactory代理工廠6.1 作用MapperProxyFactoryT是一個(gè)泛型工廠類負(fù)責(zé)為指定的 Mapper 接口生成代理對(duì)象。它被注冊(cè)在MapperRegistry.knownMappers中等待getMapper調(diào)用。6.2 核心源碼javapublic class MapperProxyFactoryT { private final ClassT mapperInterface; private final MapMethod, MapperMethodInvoker methodCache new ConcurrentHashMap(); public MapperProxyFactory(ClassT mapperInterface) { this.mapperInterface mapperInterface; } public ClassT getMapperInterface() { return mapperInterface; } public MapMethod, MapperMethodInvoker getMethodCache() { return methodCache; } // 核心方法生成代理對(duì)象 protected T newInstance(MapperProxyT mapperProxy) { return (T) Proxy.newProxyInstance( mapperInterface.getClassLoader(), new Class[]{mapperInterface}, mapperProxy); } public T newInstance(SqlSession sqlSession) { final MapperProxyT mapperProxy new MapperProxy(sqlSession, mapperInterface, methodCache); return newInstance(mapperProxy); } }關(guān)鍵點(diǎn)newInstance(SqlSession)中創(chuàng)建了一個(gè)MapperProxy然后把SqlSession、接口 Class、方法緩存?zhèn)鬟M(jìn)去Proxy.newProxyInstance傳入的接口數(shù)組只有mapperInterface因此代理對(duì)象只實(shí)現(xiàn)這一個(gè)接口代理對(duì)象不委托任何 target因?yàn)?MyBatis 沒(méi)有實(shí)現(xiàn)類代理對(duì)象自己就是實(shí)現(xiàn)6.3 methodCache為什么需要緩存methodCache是一個(gè)ConcurrentHashMapMethod, MapperMethodInvoker它緩存了方法 - MapperMethod的映射。為什么需要緩存每次調(diào)用mapper.selectById(1L)時(shí)MapperProxy.invoke()需要根據(jù)Method找到對(duì)應(yīng)的MapperMethod如果不緩存每次都要重新解析注解、拼接 statementId性能會(huì)受影響Method對(duì)象在同一個(gè)類中是唯一的作為 key 很合適用ConcurrentHashMap保證線程安全6.4 代理對(duì)象的生命周期代理對(duì)象是SqlSession級(jí)別的還是應(yīng)用級(jí)別的答代理對(duì)象由MapperProxyFactory.newInstance(sqlSession)生成每次調(diào)用sqlSession.getMapper()都會(huì)生成一個(gè)新的代理對(duì)象。但MapperProxyFactory和methodCache是應(yīng)用級(jí)別的由Configuration持有所以代理對(duì)象每次getMapper都新建但 JVM 會(huì)對(duì)相同接口的代理類進(jìn)行復(fù)用代理 Class 只會(huì)生成一次methodCache應(yīng)用級(jí)別共享方法映射只解析一次七、MapperProxy方法調(diào)用的攔截器7.1 作用MapperProxyT實(shí)現(xiàn)了InvocationHandler是所有 Mapper 方法調(diào)用的統(tǒng)一入口。7.2 核心源碼javapublic class MapperProxyT implements InvocationHandler, Serializable { private final SqlSession sqlSession; private final ClassT mapperInterface; private final MapMethod, MapperMethodInvoker methodCache; public MapperProxy(SqlSession sqlSession, ClassT mapperInterface, MapMethod, MapperMethodInvoker methodCache) { this.sqlSession sqlSession; this.mapperInterface mapperInterface; this.methodCache methodCache; } Override public Object invoke(Object proxy, Method method, Object[] args) throws Throwable { try { // 1. 如果調(diào)用的是 Object 類的方法toString、hashCode、equals直接執(zhí)行 if (Object.class.equals(method.getDeclaringClass())) { return method.invoke(this, args); } // 2. 如果調(diào)用的是接口默認(rèn)方法Java 8走默認(rèn)實(shí)現(xiàn) if (method.isDefault()) { return invokeDefaultMethod(proxy, method, args); } } catch (Throwable t) { throw ExceptionUtil.unwrapThrowable(t); } // 3. 核心獲取或創(chuàng)建 MapperMethod然后調(diào)用 final MapperMethodInvoker mapperMethod cachedMapperMethod(method); return mapperMethod.invoke(proxy, method, args, sqlSession); } private MapperMethodInvoker cachedMapperMethod(Method method) { return methodCache.computeIfAbsent(method, k - new PlainMethodInvoker(new MapperMethod(mapperInterface, method, sqlSession.getConfiguration()))); } }關(guān)鍵點(diǎn)Object 方法toString、hashCode、equals直接被代理對(duì)象自己處理默認(rèn)方法Java 8 的接口默認(rèn)方法走M(jìn)ethodHandles調(diào)用不進(jìn)入 SQL 執(zhí)行流程普通方法走M(jìn)apperMethod執(zhí)行 SQLcachedMapperMethod用computeIfAbsent保證MapperMethod只被創(chuàng)建一次7.3 PlainMethodInvoker 與 DefaultMethodInvokerMyBatis 3.5.x 引入了MapperMethodInvoker接口有兩個(gè)實(shí)現(xiàn)PlainMethodInvoker普通方法走 SQL 執(zhí)行DefaultMethodInvoker默認(rèn)方法走 Java 默認(rèn)實(shí)現(xiàn)這種設(shè)計(jì)讓默認(rèn)方法和接口方法的執(zhí)行路徑分離代碼更清晰。7.4 一個(gè)完整調(diào)用鏈textuserMapper.selectById(1L) → 代理對(duì)象.selectById(1L) → MapperProxy.invoke(proxy, selectById, [1L]) → cachedMapperMethod(selectById) // 從 methodCache 獲取或創(chuàng)建 → PlainMethodInvoker.invoke() → MapperMethod.execute(sqlSession, args) → SqlSession.selectOne(statementId, args) → Executor.query(...) → JDBC 執(zhí)行 SQL八、MapperMethod方法到 SQL 的映射8.1 MapperMethod 的組成MapperMethod是方法到 SQL 的橋梁它由兩部分組成javapublic class MapperMethod { private final SqlCommand command; private final MethodSignature method; public MapperMethod(Class? mapperInterface, Method method, Configuration config) { this.command new SqlCommand(config, mapperInterface, method); this.method new MethodSignature(config, mapperInterface, method); } }SqlCommand負(fù)責(zé)找到對(duì)應(yīng)的 SQL 語(yǔ)句MethodSignature負(fù)責(zé)解析方法的返回值、參數(shù)等信息8.2 SqlCommand從方法到 statementIdjavapublic static class SqlCommand { private final String name; // statementId private final SqlCommandType type; // SELECT / INSERT / UPDATE / DELETE public SqlCommand(Configuration configuration, Class? mapperInterface, Method method) { // 1. 拼接 statementId 接口全限定名 . 方法名 final String methodName method.getName(); final Class? declaringClass method.getDeclaringClass(); MappedStatement ms resolveMappedStatement(mapperInterface, methodName, declaringClass, configuration); if (ms null) { throw new BindingException(Invalid bound statement (not found): mapperInterface.getName() . methodName); } this.name ms.getId(); this.type ms.getSqlCommandType(); } }關(guān)鍵statementId 接口全限定名 . 方法名例如com.example.mapper.UserMapper.selectById用這個(gè) statementId 去Configuration.mappedStatements中查找MappedStatement找不到就拋出BindingException這就是Invalid bound statement的由來(lái)8.3 MethodSignature方法簽名解析MethodSignature負(fù)責(zé)解析返回值類型void、Object、List、Map、Cursor等參數(shù)位置Param注解、RowBounds、ResultHandler是否是MapKey方法返回Map時(shí)用哪個(gè)字段作為 keyjavapublic static class MethodSignature { private final boolean returnsMany; // 是否返回集合 private final boolean returnsMap; // 是否返回 Map private final boolean returnsVoid; // 是否返回 void private final boolean returnsCursor; // 是否返回 Cursor private final Class? returnType; // 返回類型 private final String mapKey; // MapKey 的值 private final Integer resultHandlerIndex; private final Integer rowBoundsIndex; private final ParamNameResolver paramNameResolver; }8.4 execute 方法根據(jù) SQL 類型分發(fā)javapublic Object execute(SqlSession sqlSession, Object[] args) { Object result; switch (command.getType()) { case INSERT: { Object param method.convertArgsToSqlCommandParam(args); result rowCountResult(sqlSession.insert(command.getName(), param)); break; } case UPDATE: { Object param method.convertArgsToSqlCommandParam(args); result rowCountResult(sqlSession.update(command.getName(), param)); break; } case DELETE: { Object param method.convertArgsToSqlCommandParam(args); result rowCountResult(sqlSession.delete(command.getName(), param)); break; } case SELECT: if (method.returnsVoid() method.hasResultHandler()) { executeWithResultHandler(sqlSession, args); result null; } else if (method.returnsMany()) { result executeForMany(sqlSession, args); } else if (method.returnsMap()) { result executeForMap(sqlSession, args); } else if (method.returnsCursor()) { result executeForCursor(sqlSession, args); } else { Object param method.convertArgsToSqlCommandParam(args); result sqlSession.selectOne(command.getName(), param); if (method.returnsOptional() (result null || !method.getReturnType().equals(result.getClass()))) { result Optional.ofNullable(result); } } break; case FLUSH: result sqlSession.flushStatements(); break; default: throw new BindingException(Unknown execution method for: command.getName()); } if (result null method.getReturnType().isPrimitive() !method.returnsVoid()) { throw new BindingException(Mapper method command.getName() attempted to return null from a method with a primitive return type ( method.getReturnType() ).); } return result; }關(guān)鍵根據(jù)SqlCommandType決定調(diào)用sqlSession.insert、update、delete還是selectOneSelect、Insert、Update、Delete注解也是在這一步被識(shí)別的九、SqlSession 與 ExecutorSQL 真正執(zhí)行的地方9.1 SqlSession用戶接口SqlSession是 MyBatis 對(duì)外的核心接口封裝了所有數(shù)據(jù)庫(kù)操作javapublic interface SqlSession extends Closeable { T T selectOne(String statement); T T selectOne(String statement, Object parameter); E ListE selectList(String statement); E ListE selectList(String statement, Object parameter); int insert(String statement); int update(String statement); int delete(String statement); // ... }它的默認(rèn)實(shí)現(xiàn)是DefaultSqlSession內(nèi)部持有一個(gè)Executor。9.2 Executor執(zhí)行器體系Executor是 MyBatis 的核心執(zhí)行器采用裝飾器模式組織textExecutor接口 ├── BaseExecutor抽象類實(shí)現(xiàn)模板方法 │ ├── SimpleExecutor簡(jiǎn)單執(zhí)行器每次新建 Statement │ ├── ReuseExecutor復(fù)用執(zhí)行器緩存 Statement │ └── BatchExecutor批量執(zhí)行器批量提交 ├── CachingExecutor二級(jí)緩存裝飾器 └── ...當(dāng)SqlSession.selectOne()被調(diào)用時(shí)執(zhí)行流程是textDefaultSqlSession.selectOne() → DefaultSqlSession.selectList() → CachingExecutor.query() // 如果開(kāi)啟二級(jí)緩存 → BaseExecutor.query() → 一級(jí)緩存查詢PerpetualCache → 緩存未命中 → queryFromDatabase() → SimpleExecutor.doQuery() → StatementHandler.prepare() → StatementHandler.parameterize() → StatementHandler.query() → ResultSetHandler.handleResultSets() → 返回結(jié)果9.3 StatementHandlerSQL 語(yǔ)句處理器StatementHandler是真正和 JDBC 打交道的地方有四種實(shí)現(xiàn)SimpleStatementHandler普通 StatementPreparedStatementHandler預(yù)編譯 Statement默認(rèn)CallableStatementHandler存儲(chǔ)過(guò)程RoutingStatementHandler根據(jù) MappedStatement 的 statementType 路由9.4 ResultSetHandler結(jié)果集處理器ResultSetHandler負(fù)責(zé)把 JDBC 的ResultSet轉(zhuǎn)換成 Java 對(duì)象主要工作自動(dòng)映射根據(jù)列名和屬性名自動(dòng)匹配手動(dòng)映射根據(jù)resultMap配置映射類型轉(zhuǎn)換調(diào)用TypeHandler把 JDBC 類型轉(zhuǎn)換為 Java 類型十、為什么 Mapper 接口不支持方法重載10.1 MyBatis 的映射規(guī)則MyBatis 的statementId是接口全限定名 . 方法名例如textcom.example.mapper.UserMapper.selectById注意這個(gè)方法名里不包含參數(shù)信息。10.2 重載會(huì)導(dǎo)致什么問(wèn)題如果 Mapper 接口定義了兩個(gè)同名方法javapublic interface UserMapper { User selectById(Long id); User selectById(Long id, boolean includeDeleted); }兩個(gè)方法對(duì)應(yīng)的 statementId 都是textcom.example.mapper.UserMapper.selectById在Configuration.mappedStatements中這個(gè) statementId 只能對(duì)應(yīng)一個(gè)MappedStatement。后注冊(cè)的會(huì)覆蓋先注冊(cè)的導(dǎo)致其中一個(gè)方法找不到 SQL或走錯(cuò) SQL。10.3 官方立場(chǎng)MyBatis 官方文檔明確說(shuō)明Mapper 接口不支持方法重載。這也是為什么 MyBatis 的 Mapper 方法命名通常很具體例如selectById、selectByUserIdAndStatus。10.4 面試加分點(diǎn)如果面試官問(wèn)為什么 Mapper 不支持重載你可以這樣回答MyBatis 的映射規(guī)則是 statementId 接口全限定名 . 方法名不包含參數(shù)信息。所以兩個(gè)同名方法會(huì)映射到同一個(gè) statementId導(dǎo)致覆蓋或沖突。如果要支持重載MyBatis 需要把參數(shù)信息也納入 statementId但這會(huì)破壞現(xiàn)有的 XML namespace id 的唯一性約束因此官方明確不支持。十一、實(shí)戰(zhàn)問(wèn)題排查11.1 常見(jiàn)錯(cuò)誤一Invalid bound statement (not found)現(xiàn)象textorg.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.example.mapper.UserMapper.selectById排查XML 的namespace是否等于 Mapper 接口的全限定名XML 的select id...是否等于方法名XML 是否在 MyBatis 的掃描路徑下mybatis.mapper-locationsMapper 接口是否被Mapper或MapperScan掃描到如果使用 Spring Boot檢查mybatis-plus或mybatis-spring-boot-starter的自動(dòng)配置11.2 常見(jiàn)錯(cuò)誤二方法重載導(dǎo)致的沖突現(xiàn)象兩個(gè)同名方法只有一個(gè)能正常工作。排查檢查 Mapper 接口是否有重載方法。如果確實(shí)需要重載改為不同方法名。11.3 常見(jiàn)錯(cuò)誤三代理對(duì)象類型轉(zhuǎn)換異?，F(xiàn)象textjava.lang.ClassCastException: com.sun.proxy.$Proxy123 cannot be cast to com.example.mapper.UserMapperImpl排查MyBatis 生成的代理對(duì)象只實(shí)現(xiàn)了 Mapper 接口不能轉(zhuǎn)換為任何實(shí)現(xiàn)類。檢查是否錯(cuò)誤地把代理對(duì)象強(qiáng)轉(zhuǎn)為具體實(shí)現(xiàn)類。11.4 常見(jiàn)錯(cuò)誤四默認(rèn)方法調(diào)用不走 SQL現(xiàn)象Mapper 接口中定義了默認(rèn)方法調(diào)用時(shí)不執(zhí)行 SQL。排查Java 8 的默認(rèn)方法走DefaultMethodInvoker不進(jìn)入 SQL 執(zhí)行流程。如果默認(rèn)方法內(nèi)部調(diào)用了接口方法那些接口方法依然會(huì)走代理執(zhí)行 SQL。11.5 常見(jiàn)錯(cuò)誤五Object 方法被誤用現(xiàn)象在代碼中調(diào)用userMapper.toString()、userMapper.hashCode()返回的是代理對(duì)象的實(shí)現(xiàn)而不是 SQL 執(zhí)行結(jié)果。排查這是正常行為MapperProxy.invoke()對(duì)Object類方法做了特殊處理。不要在 Mapper 中定義toString等方法的業(yè)務(wù)語(yǔ)義。十二、高頻追問(wèn)與回答模板12.1 高頻追問(wèn)MyBatis 的 Mapper 接口為什么能執(zhí)行 SQL動(dòng)態(tài)代理是 JDK 的還是 CGLIB 的代理對(duì)象什么時(shí)候創(chuàng)建的MapperProxyFactory和MapperProxy有什么區(qū)別MapperMethod是怎么找到 SQL 的為什么 Mapper 不支持重載Mapper 接口和 XML 的 namespace 必須一致嗎一級(jí)緩存和二級(jí)緩存在哪個(gè)環(huán)節(jié)生效多個(gè) SqlSession 使用同一個(gè) Mapper 接口代理對(duì)象是同一個(gè)嗎MyBatis 和 Spring Data JPA 的接口自動(dòng)實(shí)現(xiàn)在原理上有什么區(qū)別12.2 回答模板回答Mapper 接口為什么能執(zhí)行 SQL時(shí)可以按這個(gè)結(jié)構(gòu)組織一句話結(jié)論MyBatis 用 JDK 動(dòng)態(tài)代理為 Mapper 接口生成代理對(duì)象調(diào)用走M(jìn)apperProxy.invoke()。講啟動(dòng)階段MyBatis 啟動(dòng)時(shí)解析 XML 和注解通過(guò)MapperRegistry把接口和MapperProxyFactory關(guān)聯(lián)起來(lái)。講調(diào)用階段sqlSession.getMapper()生成代理對(duì)象調(diào)用方法時(shí)進(jìn)入MapperProxy.invoke()通過(guò)MapperMethod找到MappedStatement。講執(zhí)行階段MapperMethod.execute()根據(jù) SQL 類型調(diào)用SqlSession對(duì)應(yīng)方法最終由Executor和 JDBC 執(zhí)行。講約束statementId 是接口全限定名 方法名因此不支持方法重載namespace 必須匹配接口全限定名。12.3 對(duì)比 Spring Data JPA維度MyBatisSpring Data JPA接口實(shí)現(xiàn)方式JDK 動(dòng)態(tài)代理 MapperProxyJDK 動(dòng)態(tài)代理 RepositoryFactorySupport方法映射statementId 接口名 方法名方法名解析 Query 注解SQL 來(lái)源XML / 注解JPQL / 原生 SQL / 方法名派生靈活性高XML 可寫(xiě)復(fù)雜 SQL中復(fù)雜查詢需要 Query學(xué)習(xí)曲線中高十三、總結(jié)13.1 核心結(jié)論MyBatis 的 Mapper 接口能執(zhí)行 SQL是因?yàn)?MyBatis 用 JDK 動(dòng)態(tài)代理為接口生成了代理對(duì)象。完整鏈路text啟動(dòng)階段 解析 XML / 注解 → MapperRegistry.addMapper() → 創(chuàng)建 MapperProxyFactory → 放入 knownMappers 調(diào)用階段 sqlSession.getMapper(UserMapper.class) → MapperProxyFactory.newInstance(sqlSession) → 創(chuàng)建 MapperProxy → Proxy.newProxyInstance() 執(zhí)行階段 userMapper.selectById(1L) → MapperProxy.invoke() → MapperMethod.execute() → SqlSession.selectOne() → Executor.query() → JDBC 執(zhí)行 SQL13.2 關(guān)鍵要點(diǎn)動(dòng)態(tài)代理類型JDK 動(dòng)態(tài)代理因?yàn)?Mapper 是接口代理對(duì)象生成時(shí)機(jī)sqlSession.getMapper()時(shí)方法映射規(guī)則statementId 接口全限定名 . 方法名不支持重載因?yàn)?statementId 不含參數(shù)信息namespace 必須匹配XML 的 namespace 必須等于接口全限定名methodCache 緩存方法映射只解析一次應(yīng)用級(jí)別共享13.3 一句話總結(jié)MyBatis 的 Mapper 接口本身不會(huì)執(zhí)行 SQL能執(zhí)行 SQL 的是 MyBatis 通過(guò) JDK 動(dòng)態(tài)代理生成的代理對(duì)象。代理對(duì)象根據(jù)接口全限定名 方法名找到 SQL再交給 SqlSession 和 Executor 執(zhí)行。理解了這條鏈路你不僅能回答面試題還能在遇到Invalid bound statement、方法重載沖突、代理對(duì)象類型轉(zhuǎn)換異常等問(wèn)題時(shí)快速定位根因。