一文速览MyBatis报错“Error:(3,37) java: 无法访问org.mybatis.spring.annotation.MapperScan”

2022-11-25 18:52:23

解决 MyBatis 中“无法访问 org.mybatis.spring.annotation.MapperScan”错误的指南

在使用 MyBatis 框架时，您可能会遇到以下报错：“Error:(3,37) java: 无法访问 org.mybatis.spring.annotation.MapperScan”。此报错通常是由于缺少必要的依赖或配置引起的。本文将详细分析此报错的原因，并提供相应的解决方案。

1. 缺少依赖

对于使用 Spring Boot 的项目，在 pom.xml 文件中添加以下依赖：

<dependency>
  <groupId>org.mybatis.spring.boot</groupId>
  <artifactId>mybatis-spring-boot-starter</artifactId>
  <version>2.2.2</version>
</dependency>

对于纯 Java 项目，在 pom.xml 文件中添加以下依赖：

<dependency>
  <groupId>org.mybatis</groupId>
  <artifactId>mybatis</artifactId>
  <version>3.5.9</version>
</dependency>

<dependency>
  <groupId>org.mybatis</groupId>
  <artifactId>mybatis-spring</artifactId>
  <version>2.0.7</version>
</dependency>

2. 缺少配置

在使用 MyBatis 时，您需要在 Spring 配置文件中配置 MyBatis 的扫描路径。您可以在 application.properties 文件中添加以下配置：

mybatis.mapper-locations=classpath:mybatis/mapper/*.xml

3. 缺少注解

对于 Spring Boot 项目：

在 Mapper 接口上添加 @Mapper 注解。例如：

@Mapper
public interface UserMapper {

  List<User> findAll();

}

对于纯 Java 项目：

在 Mapper 接口上添加 @MapperScan 注解。例如：

@MapperScan("com.example.dao")
public class App {

  public static void main(String[] args) {
    SpringApplication.run(App.class, args);
  }

}

4. 缺少 XML 映射文件

如果您使用的是 XML 映射文件，则需要在 resources 目录下创建 mybatis/mapper 目录，并在该目录下创建对应的 XML 映射文件。例如：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.dao.UserMapper">

  <select id="findAll" resultType="com.example.model.User">
    SELECT * FROM user;
  </select>

</mapper>