SpringBoot无法扫描到Mapper的解决方法

一、springboot扫描不到mapper文件

在使用SpringBoot开发时，如果出现无法扫描到Mapper文件的情况，可以首先确认以下几点：

1、Mapper文件是否被放置在了正确的包路径下。

这里建议将Mapper文件放置在与主类所在的包路径下，这样SpringBoot就能自动扫描到。

├─com
│  └─example
│      └─demo
│          ├─controller
│          ├─dao
│          ├─entity
│          ├─mapper
│          ├─service
│          └─DemoApplication.java

2、Mapper文件是否被注解@MapperScan或@MapperScan(value = “com.example.demo.dao”)指定扫描到。

如果Mapper文件不在主类的同级或子级包下，需要通过在主类上使用@MapperScan或者@MapperScan(value = “com.example.demo.dao”)指定扫描到的路径，否则SpringBoot是无法自动扫描到的。

@SpringBootApplication
@MapperScan(value = "com.example.demo.dao")
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

二、springboot扫描不到mapper接口

如果使用MyBatis时，Mapper接口和Mapper.xml文件是分开的，除了前面提到的路径问题，还需要注意以下两点：

1、Mapper接口的命名和Mapper.xml文件名需要一致。

2、在Mapper接口上需要添加@Mapper注解。

@Mapper
public interface UserMapper {
    User getUserById(int id);
}

三、springboot扫描不到mapper包

如果Mapper文件和Mapper接口的包路径不同，需要在主类上指定扫描的包。

可以在@SpringBootApplication注解中添加scanBasePackages属性，指定需要扫描的包路径。

@SpringBootApplication(scanBasePackages = {"com.example.demo.mapper"})
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

四、springboot扫描不到service

如果出现Spring无法扫描到Service的情况，可以首先确认以下几点：

1、Service文件是否被放置在了正确的包路径下。

2、Service文件是否在主类的同级或子级包下。

3、主类上是否添加了@ComponentScan或者@SpringBootApplication注解。

如果在Service中需要注入Mapper，请确保Mapper已经被成功扫描到。

五、springboot扫描不到controller包

如果出现Spring无法扫描到Controller的情况，可以先确认以下几点：

1、Controller文件是否被放置在了正确的包路径下。

2、Controller文件是否在主类的同级或子级包下。

3、主类上是否添加了@ComponentScan或者@SpringBootApplication注解。

六、springboot扫描不到jar包

如果引入的jar包中有Mapper文件，但是SpringBoot无法自动扫描到，可以尝试以下方法：

1、在@SpringBootApplication注解中添加scanBasePackages属性，手动指定需要扫描的包路径。

2、手动配置MapperScannerConfigurer，指定Mapper文件所在的路径。

@Configuration
public class MyBatisConfig {
 
    @Bean
    public MapperScannerConfigurer mapperScannerConfigurer() {
        MapperScannerConfigurer mapperScannerConfigurer = new MapperScannerConfigurer();
        mapperScannerConfigurer.setSqlSessionFactoryBeanName("sqlSessionFactory");
        mapperScannerConfigurer.setBasePackage("com.example.demo.mapper");
        return mapperScannerConfigurer;
    }
}

七、springboot扫描不到controller

如果出现Spring无法扫描到Controller的情况，可能是以下情况之一：

1、Controller类没有添加@Controller注解或@RestController注解。

2、Controller类没有被放置在与主类相同或子包中。

3、主类上未添加@ComponentScan或@SpringBootApplication注解。

八、springboot扫描不到bean

如果出现Spring无法扫描到Bean的情况，可以首先检查以下问题：

1、Bean是否被注解为@Service、@Repository、@Component或@Controller。

2、Bean是否被放置在了正确的包路径下，且与主类相同或在其子包中。

3、主类上是否添加了@ComponentScan或@SpringBootApplication注解。

九、springboot扫描不到dao

如果出现Spring无法扫描到Dao类的情况，可以先检查以下几点：

1、Dao类是否被注解为@Mapper或@Repository。

2、Dao类是否被放置在了正确的包路径下，且与主类相同或在其子包中。

3、Mapper文件是否命名正确、被放置在了正确的位置，且与Dao类的包路径一致。

十、springboot扫描不到配置类

如果出现Spring无法扫描到配置类的情况，可以尝试以下方法：

1、手动在主类上使用@Import注解导入配置类。

@Import(MybatisConfig.class)
@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

2、手动在主类上添加@Configuration注解，标记该类为配置类。

@Configuration
public class MybatisConfig {
   // mybatis配置代码
}

3、手动在主类上添加@ComponentScan注解，指定配置类所在的包路径。

@ComponentScan(basePackages = "com.example.demo.config")
@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}