Swagger 大坑 之 @ApiModelProperty 注解的大坑

Swagger页面上突然少了一个接口集；@ApiModelProperty注解是不能修饰public修饰的类属性的

一、注解介绍：
@ApiModelProperty注解 是一个用来标注类属性的注解

它常用的属性有如下几个

1、name：重写属性名。

2、value：属性的中文描述。

3、dataType：重写属性类型。

4、required：是否必须。

5、example：举例说明。

6、hidden：隐藏。

二、问题发现：
我们项目中使用到了swagger，正常使用模块有两个如下图：

但是在开发过程中，一天重启项目突然发现少了一个接口集：业务模块。
项目启动报错如下图：

意思是，空指针致使扫描不到业务模块接口集到文档中。

三、问题解决：
1、在度娘上寻找相同的问题，未果。
2、通过对比代码，排查最近两天自己的操作。果然在一个实体类中发现了异常如下图：

我发现这个属性，我之前测试的时候改成public了，等我改回private神奇的发现好了，于是我去网上寻找这个注解是否可以放在public修饰的属性上。
然后未果，一堆关于ApiModelProperty注解，无关的帖子弹出来。
总结出来：@ApiModelProperty注解是不能修饰public修饰的类属性的。
然后我就记了下来，发到网上，希望能够帮助大家。

每日一语：但行好事，莫问前程。