在采用 MyBatis 进行数据访问时，通过 mapper 接口发起数据库操作需要满足哪些前提条件或约定？
考察说明
考查对 MyBatis mapper 接口绑定机制和底层调用原理的理解。
回答思路
- 【回答框架 1】MyBatis 的 mapper 接口本质上是一个 Java 接口，MyBatis 会为它生成代理实现。调用接口方法时，代理根据方法名和参数构造 SQL 并执行。接口本身不能直接实例化，必须由 MyBatis 绑定到对应的 SQL 映射。
- 【回答框架 2】要求一：接口的全限定名必须与映射文件中的 namespace 一致，否则 MyBatis 无法将接口方法对应到具体 SQL。同时，接口方法名必须与映射文件中的语句 id 相匹配，方法参数和返回类型需要与 SQL 定义兼容。
- 【回答框架 3】要求二：接口不能有显式实现类，否则 MyBatis 不会创建代理；接口方法也不能重载（即不能有相同名称但参数不同的方法），因为映射 id 是基于方法名唯一确定的。
- 【回答框架 4】要求三：在 Spring 环境下，需要通过 @MapperScan 或 @Mapper 注解将接口注册为 Bean，并保证映射文件被正确加载（例如放在 classpath 的 mapper 目录并配置 mapperLocations）。使用 SqlSessionTemplate 时同样能获取代理。
- 【回答框架 5】要求四：接口方法参数如果是简单类型，可以使用注解 @Param 显式命名，便于在 SQL 中引用；如果参数是 POJO 或 Map，则不需要额外指定。返回结果可以是实体、Map、简单类型或集合，MyBatis 会根据配置自动映射。
- 【关键点 1】接口全限定名必须与映射文件 namespace 一致，方法名与语句 id 一致。
- 【关键点 2】接口不能有实现类，也不能重载方法。
- 【关键点 3】Spring 环境需通过扫描注解注册接口，并正确加载映射文件。
- 【关键点 4】参数可用 @Param 命名，返回类型与 SQL 结果集匹配。
- 【易错点 1】接口与映射文件绑定错误时常见 BindingException，需检查 namespace 和方法 id。
- 【易错点 2】接口方法重载会导致 MyBatis 无法唯一确定 SQL，应避免。
- 【易错点 3】映射文件未加载时接口能注入但调用报错，需检查 MyBatis 配置的映射位置。