springcloud整合swagger2

悠悠 2023-10-18 15:25 40阅读 0赞

参考[https://blog.csdn.net/ityqing/article/details/81217383][https_blog.csdn.net_ityqing_article_details_81217383]的消息，2.2.2版本的与feign有冲突! 会报bean创建加载异常!

在`pom.xml`中加入Swagger2的依赖

<dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger2</artifactId>
        <version>2.5.0</version>
    </dependency>
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger-ui</artifactId>
        <version>2.5.0</version>
    </dependency>

在启动类同级目录下创建swagger2配置类

@Configuration
    @EnableSwagger2
    public class Swagger2 {
    
    	@Bean
    	public Docket createRestApi() {
    		return new Docket(DocumentationType.SWAGGER_2)
    				.apiInfo(meta())
    				.select()
    				.apis(RequestHandlerSelectors.basePackage("com.test"))//扫描的包路径
    				.paths(PathSelectors.any())
    				.build();
    	}
    	
    	private ApiInfo meta() {
    		return new ApiInfoBuilder()
    				.title("我的API")
    				.description("这是我的接口文档")
    				.version("1.0.1")
    				.build();
    	}
    }

在启动类加注解@EnableSwagger2，开启swagger2

@SpringBootApplication
    @EnableSwagger2
    public class TestApplication {
        public static void main(String[] args) {
            SpringApplication.run(TestApplication .class, args);
        }
    
    }

启动后访问[http://localhost:8080/swagger-ui.html][http_localhost_8080_swagger-ui.html]

#### 注意！！！如果遇到以下错误： ####

No mapping found for HTTP request with URI \[/swagger-ui.html\]

原因是Spring Boot自动配置本身不会自动把/swagger-ui.html这个路径映射到对应的目录META-INF/resources/下面，

需要增加配置文件，增加映射

如下：

@Configuration
    public class WebMVCConfig extends WebMvcConfig {
        @Override
        public void addResourceHandlers(ResourceHandlerRegistry registry) {
            registry.addResourceHandler("swagger-ui.html")
                    .addResourceLocations("classpath:/META-INF/resources/");
            registry.addResourceHandler("/webjars/**")
                    .addResourceLocations("classpath:/META-INF/resources/webjars/");
    
        }
    
    }

继续访问，正常！

[https_blog.csdn.net_ityqing_article_details_81217383]: https://blog.csdn.net/ityqing/article/details/81217383
[http_localhost_8080_swagger-ui.html]: http://localhost:8086/swagger-ui.html