文章目录一、问题描述二、问题原因三、解决方法3.1、修改dataType=int3.2、修改dataType=Long3.3、修改dataType类型为String类型3.4、当dataType类型为Integer时，删除required=true以下内容基于swagger2.9.2进行讲解<!--swagger2--><dependency> <groupId>io.sp

API使用说明作用范围APIAPI常用参数作用位置协议集描述@Api@Api(tags={"tag1","tag2","..."})controller类协议描述@ApiOperation@ApiOperation(value="功能描述",notes="备注")controller类的方法描述返回对象的意义@ApiModel@ApiModel

背景介绍：刚开始的时候，在controller层使用@RequestParam的时候，发现这个参数是必须要输入值的，但是我们有时候必须查询的时候允许参数为空，使用这个注解就不行了。在集成了swagger2后，找了半天的原因，发现使用@ApiImplicitParam这个注解可以解决这个问题。对应下面的参数。所以我们可以使

使用swagger后，所有controller中的方法都会自动生成接口；但是并不完美，需要配合swagger的注解来进行接口说明的完善(在代码中添加了注释，方便阅读)。可以导入到Yapi中，免去手动创

@Api@Api：用在请求的类上，表示对类的说明tags="说明该类的作用，可以在UI界面上看到的注解"value="该参数没什么意义，在UI界面上也看到，所以不需要配置"@Api

一、说明        1、备份下swagger用法二、注解使用1、用于Controller1）注解@Api(tags="登录")说明：归类，即一级菜单示例：~~2、用于请求1）注解@ApiOperation("账号密

背景介绍：刚开始的时候，在controller层使用@RequestParam的时候，发现这个参数是必须要输入值的，但是我们有时候必须查询的时候允许参数为空，使用这个注解就不行了。在集成了swagg

转载自：https://www.bbsmax.com/A/WpdKlbDqzV/注解：@ApiImplicitParams@ApiImplicitParam   name="需注解的API输入参数"，value="接收参数的意义描述"，paramType="参

dataType="int"代表请求参数类型为int类型，当然也可以是Map、User、String等；paramType="body"代表参数应该放在请求的什么地方：  header-->放在请求头。请求参数的