swagger




(1)什么是Swagger



官网:https://swagger.io/






(2)springboot集成swagger


要求:jdk 1.8 + 否则swagger2无法运行


  • 1.新建一个springboot-web项目

  • 2.导入相关依赖
 
            io.springfox
            springfox-swagger2
            2.9.2
        
        
        
            io.springfox
            springfox-swagger-ui
            2.9.2
        

  • 3.编写HelloController,测试确保运行成功


  • 4.配置swagger

要使用Swagger,我们需要编写一个配置类-SwaggerConfig来配置 Swagger


@Configuration
@EnableSwagger2// 开启Swagger2的自动配置
public class SwaggerConfig {

}

  • 5.访问测试 :http://localhost:8080/swagger-ui.html ,可以看到swagger的界面

启动报错:Error starting ApplicationContext

我的sprinboot版本:2.6.x swagger:2.9.2和3.0.0均会报错

这里可以参考:https://www.jb51.net/article/239659.htm

把springboot降低版本为2.5.10或者2.4.0 再配合swagger2.9.2即可运行正常