本文介绍了如何在SpringBoot项目中集成Swagger2，以自动化生成API接口文档。在集成过程中，需要注意SpringBoot和Swagger2的版本匹配问题，以及配置Maven依赖、Swagger2配置类、XML配置、过滤器设置等步骤。同时，文章还列举了Swagger2常用注解的使用方法。
最近项目开发大都是前后端分离，在编写后端接口时，往往需要向前端提供API接口文档。现在公司项目的做法大都是写完后端API接口后，再在Rap上编写API接口说明文档，这种方式对维护API文档的更新很不灵活，所以在自己单独负责一个后端接口工程时，就研究了一下引入Swagger.
在以前的项目经历中也早引用过swagger，但自己没有亲手集成过。今天所以再回顾和整理下，大体做个总结。
一、引入maven依赖。这里提醒一下，springBoot中集成swagger2 注意版本，不然启动会报错，这个问题下次有空再看看。我这里是SpringBoot版本1.4.4，swagger2版本是2.5.0。【第一次引用的是2.6.1报错】
二、新增swagger2配置类。这里我也截个图：
三、在做完第一步 和 第二步时，启动没报错。但你去访问时，比如：https://192.168.1.128:8892/xxxDemo/swagger-ui.html#/，会报404错误。这里是因为还需要再配置一下.
一个是xml配置文件配置：
最低0.47元/天 解锁文章
扫一扫
1000
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
