问题：MyBatis插件报错找不到接口方法？

Question

在使用 MyBatis 插件时，常有开发者遇到“找不到接口方法”的报错。该问题通常发生在插件尝试拦截或修改某个 Mapper 接口方法时，但目标方法不存在或签名不匹配。常见原因包括：插件配置错误、拦截器未正确指定目标方法、接口方法未被正确加载或接口未被代理。此外，MyBatis 与 Spring 整合时，若接口未被正确扫描或代理生成失败，也会导致方法查找失败。排查此类问题应从插件配置、拦截注解使用、接口绑定、以及日志输出入手，确认目标方法是否真实存在并被正确识别。掌握这些关键点，有助于快速定位和解决 MyBatis 插件中“找不到接口方法”的异常问题。

Answer 1

一、问题背景与浅层理解

在使用 MyBatis 插件时，开发者常常会遇到“找不到接口方法”的报错。该问题通常发生在插件尝试拦截或修改某个 Mapper 接口方法时，但目标方法不存在或签名不匹配。

MyBatis 插件机制通过拦截器实现对 SQL 执行流程的增强，例如日志打印、分页、权限控制等。然而，若拦截器配置不当或目标方法未被正确识别，就会导致运行时抛出异常。

二、常见原因分析

• 插件配置错误：MyBatis 插件的配置项未正确指向目标接口或方法。
• 拦截器未正确指定目标方法：使用 @Intercepts 和 @Signature 注解时，方法签名未正确匹配。
• 接口方法未被正确加载：Mapper 接口未被 MyBatis 加载或绑定。
• 接口未被代理：Spring 与 MyBatis 整合时，接口未生成代理类。
• 扫描路径配置错误：Mapper 接口未被正确扫描，导致无法被 Spring 或 MyBatis 管理。

三、问题排查流程图

graph TD
A[启动应用] --> B{是否配置插件?}
B -- 是 --> C{拦截器是否指定正确方法签名?}
C -- 是 --> D{Mapper接口是否被正确加载?}
D -- 是 --> E{是否被Spring代理?}
E -- 是 --> F[正常运行]
E -- 否 --> G[报错:找不到接口方法]
D -- 否 --> G
C -- 否 --> G
B -- 否 --> H[插件未生效]

四、从配置入手排查问题

检查 MyBatis 插件配置是否正确，示例如下：

确保拦截器类路径正确，并且实现了 Interceptor 接口。

五、拦截器注解的正确使用

拦截器使用 @Intercepts 和 @Signature 注解来指定拦截目标，示例如下：

@Intercepts({@Signature(type = Executor.class, method = "query", args = {MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class})})
public class MyInterceptor implements Interceptor {
    ...
}

若 method 或 args 不匹配，将导致“找不到接口方法”的错误。

六、接口绑定与代理生成

在 Spring 与 MyBatis 整合中，Mapper 接口需要被正确扫描并生成代理类。检查以下配置：

• Mapper 接口上是否有 @Mapper 注解。
• 是否使用了 @MapperScan 注解进行包扫描。
• Spring Boot 中是否配置了正确的 Mapper 扫描路径。

示例配置：

@MapperScan("com.example.mapper")

七、日志输出辅助排查

启用 MyBatis 的日志输出，有助于查看插件和接口的加载情况：

通过日志可以确认插件是否成功注册，以及 Mapper 接口是否被正确加载。

八、进阶问题与解决思路

问题类型	可能原因	解决方案
插件未生效	插件配置未加载	检查插件配置文件路径和语法
方法签名不匹配	拦截器中 method 或 args 错误	对照接口方法签名修正注解
接口未代理	Spring 未扫描到接口	使用 @MapperScan 或 @Mapper 注解
方法未加载	Mapper XML 未绑定接口方法	检查 XML 中的 namespace 和 SQL ID 是否匹配