swagger-ui.html无法访问

Question

http://localhost:8080/v2/api-docs，可以正常访问，有正确的接口信息返回。但是访问http://localhost:8080/swagger-ui.html会报出status code 302，然后自动跳转到http://localhost:8081/swagger-ui/index.html官方示例。

Answer 1

引自免费微信小程序：皆我百晓生

面对swagger-ui.html无法访问的问题，当http://localhost:8080/v2/api-docs可以正常访问但http://localhost:8080/swagger-ui.html出现302状态码并重定向至非预期地址的情况，通常意味着Swagger UI的静态资源路径配置存在问题。以下是解决这一问题的步骤：

1. 配置Swagger UI的资源路径

确保你的Spring Boot应用中的Swagger配置正确指向了静态资源的位置。在Spring Boot中，这通常涉及到在@EnableWebMvc注解存在与否的情况下调整配置。

对于不使用@EnableWebMvc的应用:

在你的配置类中，应确保Docket bean正确设置，并且Springfox.documentation.swagger2.web.SwaggerResource被正确配置以指向API文档的URL。

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
          .select()
          .apis(RequestHandlerSelectors.any())
          .paths(PathSelectors.any())
          .build();
    }
}

对于使用@EnableWebMvc的应用:

你需要自定义WebMvcConfigurer以包含Swagger UI的资源处理。

@Configuration
@EnableSwagger2WebMvc
public class SwaggerConfig implements WebMvcConfigurer {

    @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/");
    }

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
          .select()
          .apis(RequestHandlerSelectors.any())
          .paths(PathSelectors.any())
          .build();
    }
}

2. 检查application.properties或application.yml

确保没有错误地配置了任何与Swagger UI相关的路径。例如，springfox.documentation.swagger.v2.path应该指向/v2/api-docs。

3. 清除缓存与重启服务

有时候，服务器缓存可能会导致配置更改不生效。清除浏览器缓存并重启应用服务器，确保所有更改都被正确加载。

4. 检查依赖版本

确认你的项目中使用的springfox-swagger2和springfox-swagger-ui版本是兼容的。过时或不匹配的版本可能导致此类问题。

5. 使用日志排查

增加日志级别，以便在开发环境中查看更详细的HTTP请求和响应信息。这有助于识别重定向的具体原因。

如果上述步骤未能解决问题，建议深入检查网络请求，可能需要使用如Postman或浏览器开发者工具的Network标签页来进一步诊断问题所在。确保所有的静态资源（如CSS、JS文件）都正确加载并且没有404错误。

希望这些信息能帮助你解决swagger-ui.html无法访问的问题。如果有其他具体疑问或遇到新的障碍，随时提问。