swagger的ApiImplicitParam注解中的required属性不起作用

问题的发现

如上两图，在接口中使用了’ApiImplicitParam’注解，仅指定了一个参数是必填，但是通过swagger文档查看三个参数均不能为空。

原因探究

最终确定到因为在@RequestParam中也有一个required属性，用于指定是否必填。swagger文档在处理时，对于required属性的优先级，@RequestParam注解的优先级高于@ApiImplicitParam。

解决方案

指定一下@RequestParam注解中的required属性为false即可。