springboot项目启动异常 - required a single bean, but 2 were found

问题描述

springboot+mybatis，编写接口及实现类，并使用@Autowired注入controller, 启动异常：required a single bean, but 2 were found

controller接口：

@RestController
@RequestMapping("/api/sys/statistic")
public class StatisticController {

    @Autowired
    private ISysAccessLogService iSysAccessLogService;
    
}

接口及实现类

详细错误信息

APPLICATION FAILED TO START
Description:

Field iSysAccessLogService in com.msb.sys.controller.StatisticController required a single bean, but 2 were found:
- sysAccessLogServiceImpl: defined in file [/Users/myname/java/msbjava/target/classes/com/msb/sys/service/impl/SysAccessLogServiceImpl.class]
- ISysAccessLogService: defined in file [/Users/myname/java/msbjava/target/classes/com/msb/sys/service/ISysAccessLogService.class]

Action:

Consider marking one of the beans as @Primary, updating the consumer to accept multiple beans, or using @Qualifier to identify the bean that should be consumed

Disconnected from the target VM, address: ‘127.0.0.1:61739’, transport: ‘socket’

错误分析

根据提示，StatisticController中没办法自动注入iSysAccessLogService。

@Autowired默认按照类型注入，根据提示，我的项目中这个类型的bean有两个，因此无法自动注入。

错误信息也给出了解决的办法：
1.把其中一个bean加上@Primary注解，就可以作为默认使用，
2.在注入的属性添加@Qualifier指定beanName，以明确使用哪一个bean

但我只写了一个接口的实现类，按预期只有一个bean，应该是没问题的。

原因

经过一圈排查，
发现我在springboot的启动类上添加了注解： @MapperScan(“com”)。

@MapperScan这个是注解是mybatis的Mapper扫描注解，
并且我指定的扫描范围是com包。

1. Mybatis扫描com下的接口，生成接口的实现类，注入到Spring容器。
2. Spring框架扫描到我编写的接口实现类，注入Spring容器，因此就有了两个bean

解决办法

1、在springboot项目中建议直接在Mapper接口上添加@Mapper，不要使用@MapperScan。

2、若要使用@MapperScan注解，注意配置好扫描的范围，避免重复扫描注入spring bean导致出现上述问题。