Swagger3接口文档显示参数错误问题

问题1：接口文档不显示我们Form中的参数信息，直接就是一片空白，大多出现在添加编辑这样的接口中。

 

解决办法：将controller和form下的swagger注解中value参数内容去掉"-"或者"/"，使用全文字描述；

原因：Swagger注解会识别特殊符号“-”或者“/”，导致显示出问题。

 

问题2：接口文档显示的参数并不是我们在Form中定义的，例如：我们在Form中没有定义分页参数，但是文档中有分页参数。
解决办法：修改Form下的swagger注解中的value值，就是用另外一种说法来描述该Form。

 

原因：form下的swagger注解中value值和其他的form的swagger注解value值相同导致的，这样Swagger会默认加载另外一个类中的注解内容，然后你定义的Form会被多加一些参数。