@ConditionalOnProperty使用注意事项

笔者前几天使用@ConditionalOnProperty注解配置多个过滤器的过程中碰到了一个问题，在这里记录下

---

先简单介绍下@ConditionalOnProperty注解的功能吧，之后笔者再描述自身遇到的那些问题的时候，会更好理解一些

一、@ConditionalOnProperty的功能

它主要是通过自身的两个属性来控制自动配置是否生效，这两个属性分别是name、havingValue。只有当配置文件（application.properties或者bootstrap.yml）中和name相同的属性的值和注解上havingValue的值相同时，该配置文件才会生效，如下方代码：

配置类

@ConditionalOnProperty(value = "muyichen.auth.test", havingValue = "true")
@Component
public class AuthorizationFilterImpl implements AuthorizationFilter {
	//具体的过滤逻辑
}

配置文件

muyichen.auth.test=true

二、使用过程中遇到的问题

当笔者尝试给两个以上的过滤器添加该属性时，应用程序启动报错，如下图：

***************************
APPLICATION FAILED TO START
***************************

Description:

Parameter 0 of method authorizationFilter in com.muyichen.demo.config.WebConfiguration required a single bean, but 2 were found:

造成这个问题的主要原因是：AuthorizationFilter是笔者自己定义的一个过滤器接口，它继承了Filter接口，但并没有做任何实现，当servlet开始识别过滤器时，由于AuthorizationFilter接口并没有做主从读取逻辑的配置，所以servlet无法判别哪个是主要的过滤器配置，当几个容器间的配置出现冲突时，无法判别以谁为主。

解决办法

可以给某个主要的配置类加上@Primary注解来标示出该配置类是主配置类，当其它配置类与该类冲突时，以该类为主。这样就可以解决上述问题了