swagger里面显示的示例参数格式错误

swagger的配置和用法,在此就不做过多赘述了,在使用过程中,可能有的朋友会遇到这样的情况,这个接口显示的示例参数,却是另一个接口的参数格式,这个对后端自测的角度来说,非常不友好。但只要把参数手动改成正确的格式,后端接口还是能正确接收的。

我们习惯使用DTO作为接口的入参,一个DTO对象往往需要标注@ApiModel注解,我们从原备注信息能够获得该注解的详情。
在这里插入图片描述能够针对我们的接口入参对象提供额外的信息,也就是能够根据后端入参的数据接口,显示一个可测试的数据对象,一个json格式的对象。
而出现这个接口显示另外一个接口的入参数据接口,就是因为这个注解里的参数冲突了,比如所我有两个保存接口,虽然后端DTO不一样,但是DTO我都标注为@ApiModel("保存对象DTO"),这样就有可能两个接口显示的入参格式是一样的。

Guess you like

Origin blog.csdn.net/qq_41885819/article/details/117152031