温馨提示×

温馨提示×

您好,登录后才能下订单哦!

密码登录×
登录注册×
其他方式登录
点击 登录注册 即表示同意《亿速云用户服务条款》

如何解决swagger2.9.2接口文档显示的各种问题

发布时间:2021-06-25 17:39:51 来源:亿速云 阅读:459 作者:chen 栏目:开发技术

这篇文章主要讲解了“如何解决swagger2.9.2接口文档显示的各种问题”,文中的讲解内容简单清晰,易于学习与理解,下面请大家跟着小编的思路慢慢深入,一起来研究和学习“如何解决swagger2.9.2接口文档显示的各种问题”吧!

swagger2.9.2接口文档显示

swagger版本:2.9.2

框架:springboot2.1.2

当没有使用

@ApiImplicitParam和response=Resp.class时,swagger会自动去显示接口入参对象的各属性,及响应的对象属性,如下图:

如何解决swagger2.9.2接口文档显示的各种问题

如何解决swagger2.9.2接口文档显示的各种问题

如何解决swagger2.9.2接口文档显示的各种问题

而如果加入@ApiImplicitParam和response=Resp.class时,则没有任务字段属性显示,如下:

如何解决swagger2.9.2接口文档显示的各种问题

所以建议,当接口的入参为几个字段属性时可以加上@ApiImplicitParam进行描述,如果是对象,则只要在该 VO对象用@ApiModel和@ApiModelProperty进行注解后,在接口方法上就不需要加@ApiImplicitParam了,swagger会自动进行解析。

如何解决swagger2.9.2接口文档显示的各种问题

Spring Boot整合swagger2.9.2版本出现的小问题

访问接口文档地址时,单个应用能正常访问swagger-ui.html页面

但F12看到请求接口有报错:

如何解决swagger2.9.2接口文档显示的各种问题

但因为在gateway网关进行了各个服务的接口文档聚合,所以在gateway访问时一直报错,因此最后只能降版本,讲到Swagger2.8.0版本。

然后请求时相比2.9.2版本少了两个请求:

如何解决swagger2.9.2接口文档显示的各种问题

这算是2.9.x版本的一个小问题吧,可以看github提交的问题

感谢各位的阅读,以上就是“如何解决swagger2.9.2接口文档显示的各种问题”的内容了,经过本文的学习后,相信大家对如何解决swagger2.9.2接口文档显示的各种问题这一问题有了更深刻的体会,具体使用情况还需要大家实践验证。这里是亿速云,小编将为大家推送更多相关知识点的文章,欢迎关注!

向AI问一下细节

免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。

AI