swagger无法访问到API文档报404

时间: 2023-03-26 07:03:53 浏览: 523

Spring Boot引入swagger-ui 后swagger-ui.html无法访问404的问题

主要介绍了Spring Boot引入swagger-ui 后swagger-ui.html无法访问404的问题及解决方法，本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下在Spring Boot应用中，Swagger是一个强大的工具，它可以帮助开发者生成、描述、测试和展示RESTful API。Swagger UI是Swagger的一部分，提供了一个用户友好的界面，允许用户交互式地浏览和测试API。然而，在Spring Boot中引入Swagger UI时，有时会遇到访问`swagger-ui.html`返回404错误的问题。以下是对这个问题的详细分析和解决方案：要引入Swagger的相关依赖，需要在项目的`pom.xml`文件中添加Springfox的`springfox-swagger2`和`springfox-swagger-ui`两个依赖项，如下所示： ```xml <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.9.2</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.9.2</version> </dependency> ``` 接下来，创建一个配置类`Swagger2Config`，使用`@EnableSwagger2`注解开启Swagger功能，并通过`@Bean`方法定义一个Docket实例，来指定需要扫描的API路径： ```java @Configuration @EnableSwagger2 @Profile("swagger") @ComponentScan("xxx.controller") public class Swagger2Config { @Bean public Docket createRestApi() { return new Docket(DocumentationType.SWAGGER_2) .apiInfo(apiInfo()) .enable(true) .select() .apis(RequestHandlerSelectors.basePackage("xxx.controller")) .paths(PathSelectors.any()) .build(); } private ApiInfo apiInfo() { return new ApiInfoBuilder() .title("XXX Rest Server") .description("XXX Rest接口") .contact(new Contact("contract", "url", "email")) .version("1.0") .build(); } } ``` 当访问`swagger-ui.html`出现404错误时，通常是因为Spring Boot的静态资源处理配置问题。在某些情况下，如果项目中存在自定义的`WebMvcConfigurer`，可能会覆盖默认的静态资源处理，导致Swagger UI的资源找不到。为了解决这个问题，可以在`WebMvcConfig`类中覆盖`addResourceHandlers`方法，显式地添加Swagger UI的资源路径： ```java @Configuration public class WebMvcConfig implements WebMvcConfigurer { @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/**").addResourceLocations("classpath:/static/"); registry.addResourceHandler("swagger-ui.html") .addResourceLocations("classpath:/META-INF/resources/"); registry.addResourceHandler("/webjars/**") .addResourceLocations("classpath:/META-INF/resources/webjars/"); } } ``` 这样，Swagger UI的静态资源就可以被正确地加载，从而可以正常访问`swagger-ui.html`。除此之外，为了使前端更好地利用Swagger生成的API文档，可以考虑使用前端库（如Vue.js的typescript版本）来自动化生成调用API的代码。例如，可以参考文章中提到的开源npm库，以便前端使用axios更方便地调用API。总结来说，解决Spring Boot引入Swagger UI后`swagger-ui.html`无法访问的问题，关键在于正确配置Swagger的依赖和自定义`WebMvcConfigurer`以处理Swagger UI的静态资源。同时，为提升开发效率，前端可以利用相关工具自动根据Swagger生成的API文档构建调用代码。通过这些步骤，可以确保Swagger在Spring Boot项目中的顺畅使用，提高API的开发和测试效率。

您好，这个问题可能是由于API文档的路径配置不正确或者API文档的生成出现了问题导致的。您可以检查一下API文档的路径是否正确，并且确认API文档是否已经成功生成。如果问题仍然存在，您可以尝试重新生成API文档或者检查一下API文档生成工具的配置是否正确。希望能够帮到您。

阅读全文

swagger无法访问到API文档报404

相关推荐

swagger ui API文档工具

swagger书写API文档框架

SpringBoot结合Swagger2自动生成api文档的方法

swagger：使用swagger的API文档

swagger-rest-api-documentation:Swagger REST API文档示例

使用gin-swagger自动生成Swagger API文档

SpringBoot集成Swagger：打造RESTful API文档

SpringBoot与Swagger：自动化API文档生成指南

Swagger-UI：API文档编写与调试神器

Swagger UI：Trunkit API 文档生成与交互指南

SpringBoot集成Swagger：自动化API文档生成与测试

利用Swagger自动化生成API文档：提升团队协作效率

高级swagger技巧：自定义API文档

使用Swagger自动生成RESTful API文档

使用Swagger构建教务系统API文档

Gin框架中的Swagger文档集成与API文档编写：文档化API操作与使用

使用Swagger和SpringBoot实现API文档化

swagger2生成api接口文档

基于java的贝儿米幼儿教育管理系统答辩PPT.pptx

最新推荐

Spring Boot引入swagger-ui 后swagger-ui.html无法访问404的问题

Asp.Net Core使用swagger生成api文档的完整步骤

将Swagger2文档导出为HTML或markdown等格式离线阅读解析

Spring boot集成swagger2生成接口文档的全过程

SpringMVC如何在生产环境禁用Swagger的方法

探索AVL树算法：以Faculdade Senac Porto Alegre实践为例

管理建模和仿真的文件

【ggplot2绘图技巧】：R语言中的数据可视化艺术

HAL库怎样将ADC两个通道的电压结果输出到OLED上？

小学语文教学新工具：创新黑板设计解析