Spring Boot集成MyBatis时，yml配置了MyBatis却找不到Mapper，怎么办？

mybatis mapper 扫描配置问题及解决方法

在使用 spring boot 集成 mybatis 时，常常会遇到配置了 mybatis 的 yml 文件，却仍然报错找不到 mapper 的情况。本文将针对“在yml中配置了mybatis，但是却报错找不到mapper”这一问题进行分析和解答。

问题描述：

开发者在使用 spring boot 开发项目时，按照网上的教程配置了 mybatis，并使用了 @mapper 注解，但仍然出现以下错误：field tagmapper in com.example.demo.service.tagservice required a bean of type 'com.example.demo.mapper.tagmapper' that could not be found. 错误信息表明，spring 容器无法找到 com.example.demo.mapper.tagmapper 类型的 bean，导致依赖注入失败。 开发者提供的代码片段显示了 tagservice 中注入了 tagmapper，而 tagmapper 接口未能被 spring 容器正确识别和注册为 bean。

问题原因及解决方法：

虽然较新版本的 spring boot 会默认扫描启动类所在包及其子包下的 mapper 接口，并将其注册为 bean，但仍可能存在一些特殊情况导致扫描失败。 问题的关键在于 spring 容器未能成功发现并注册 tagmapper 接口。 答案中提到的“一般得加mapperscann告诉容器去扫描哪个包” 指的是使用 @mapperscan 注解或在 yml 配置文件中配置 mapper 扫描路径。 虽然新版本的 spring boot 已经做了默认配置，但如果项目的包结构较为复杂，或者启动类不在合适的路径下，默认扫描机制可能失效。

为了解决这个问题，开发者可以尝试以下方法：

1. 检查启动类位置: 确保你的 @springbootapplication 注解所在的启动类位于合适的包路径下。spring boot 默认扫描该类所在的包及其子包下的组件。如果你的 tagmapper 接口不在启动类所在包或其子包中，则需要显式地进行扫描。
2. 使用 @mapperscan 注解: 在启动类上添加 @mapperscan("com.example.demo.mapper") 注解，明确指定需要扫描的 mapper 接口所在的包路径。 其中 "com.example.demo.mapper" 需要替换为你的 tagmapper 接口所在的实际包路径。
3. 在 yml 文件中配置 mapper 扫描路径: 这是一种替代 @mapperscan 注解的方式，在 yml 配置文件中添加相应的配置，例如：

mybatis:
  mapper-locations: classpath*:mapper/*.xml
  scan-base-packages: com.example.demo.mapper

通过以上方法，可以明确告诉 spring 容器去哪里寻找 tagmapper 接口，从而解决找不到 mapper 的问题。 需要注意的是，classpath*:mapper/*.xml 这一行是可选的，用于指定 mybatis xml 配置文件的位置，如果你的 mapper 接口使用注解方式，则可以忽略此行。

最终，选择哪种方法取决于你的项目结构和个人偏好。 通过仔细检查项目结构和配置，并尝试上述方法，就能有效解决这个问题。