安装swagger过程及遇到问题

参考:欢迎点击原文:https://www.cnblogs.com/liconglong/p/11477401.html(主要)
https://blog.csdn.net/liangjiabao5555/article/details/107021911/

原来知道swagger会影响项目效率,想就忽略这个知识点的,没想到公司项目需要用到这个,没办法自己手动搞一个吧。

首先先普及下认知,swagger就是个接口平台,可以嵌入到项目中,这样就不用自己写接口文档了,而且各种版本都有,这边就以java为例展开

安装前端的swagger

  1. 过程忽略,百度很多,这边就说遇到的问题,安装是显示安装成功了,然后本地执行:http-server -p 8000,然后浏览器访问,命令框直接显示进程停止,报错:swagger TypeError: Readable.from is not a function,百度了半天没结果,参考这位老哥的博客也是用mac安装的环境,执行下npm start就可以了,这个命令百度了下说是安装所有这个前端项目中package.json里面的依赖,然后自动启动成功。
  2. 还有按照教程启动了个Swagger Ui,这个类似于定制你的页面我是这样理解的

srpingboot安装swagger
这个安装过程也是忽略,无非就是加pom依赖,编写config,controller上加swagger注解,主要遇到的问题有如下:

  1. 在这里插入图片描述
    上图报错解决方式是原来我用的是swagger2.2.2,百度出来建议2.9.2就可以了
  2. 在这里插入图片描述
    上图很明显说的guava19有冲突,百度出来换成20就行了。

总结: 按照流程安装是不难,但是这个途中会遇到各种意想不到的情况,这个才是考验人的地方,也不能光靠百度,自己总结尝试也是很重要的,对了maven冲突处理还是很薄弱,要改进。

posted @ 2021-12-17 15:39  蜗牛使劲冲  阅读(7)  评论(0编辑  收藏  举报  来源