spring Boot集成mybatis：Mapper掃描配置詳解及疑難解答
在spring boot項目中整合MyBatis時，一個常見問題是：YAML配置文件已正確配置，卻仍然提示找不到Mapper。本文將深入剖析此問題，并提供有效的解決方案。
問題現象：
開發者在Spring Boot和MyBatis項目中，YAML文件已正確配置MyBatis參數，但運行時出現類似以下錯誤：Field tagMapper in com.example.demo.service.TagService required a bean of type ‘com.example.demo.mapper.TagMapper’ that could not be found. 這表明spring容器無法找到TagMapper接口對應的Bean，即使使用了@Mapper注解。
問題根源：
錯誤信息明確指出Spring容器找不到com.example.demo.mapper.TagMapper Bean。雖然使用了@Mapper注解，但Spring Boot需要知道Mapper接口的掃描路徑。雖然新版Spring Boot默認掃描啟動類所在的包及其子包，但如果Mapper接口不在這些包內，或項目結構特殊，則需手動配置掃描路徑。
解決方案：
核心在于明確告知Spring Boot Mapper接口的掃描路徑。最佳實踐是在啟動類上添加@MapperScan注解，并指定掃描包路徑，例如：@MapperScan(“com.example.demo.mapper”)。這將指示Spring Boot在com.example.demo.mapper包及其子包中查找并注冊所有Mapper接口。
總結：
通過在啟動類添加@MapperScan注解并指定正確的包路徑，可以有效解決Spring Boot找不到MyBatis Mapper的問題。 若問題依舊，請仔細檢查Mapper接口路徑及啟動類位置是否符合默認掃描規則。 確保@Mapper注解已正確應用于Mapper接口。
