java - 如何更改 Swagger-ui URL 前缀？

Question

我正在使用 Springfox Swagger2 和 Spring boot 1.5.9。

我可以通过此链接访问 swagger UI。

http://localhost:8090/swagger-ui.html

如何更改它以在以下 URL 上可用？

http://localhost:8090/my/custom/path/swagger-ui.html

@EnableSwagger2
public class Configuration {

@Bean
public Docket api() { 
    return new Docket(DocumentationType.SWAGGER_2)  
      .select()
      .apis(RequestHandlerSelectors.basePackage("my.favorite.package"))
      .paths(PathSelectors.any())
      .build()
      .apiInfo(apiInfo()).useDefaultResponseMessages(false);
}

private ApiInfo apiInfo() {
    return new ApiInfoBuilder().title("My title").version("1.0")
            .contact(new Contact("Blah", "blah.com", "blah@blah.com")).build();
}
}

Answer 1

UPD:Springfox 被遗弃

Springfox Swagger 一直是一个有点脏的解决方案，有很多不清楚和错误，但到现在(2021 年第四季度)它已经一年多没有更新了。

最后一根稻草是 Springfox Swagger 3.0 doesn't work anymore with Spring Boot 2.6.x.

因此，如果您正在阅读本文，请考虑切换到 https://springdoc.org/相反。

It's a pretty straightforward conversion and they do a great job ofdocumenting it. https://springdoc.org/#migrating-from-springfox.

原始答案

我找到了适用于 Springfox 3.0.0 的有效解决方案 here :

springfox:
  documentation:
    swaggerUi:
      baseUrl: /documentation
    openApi:
      v3:
        path: /documentation/v3/api-docs
    swagger:
      v2:
        path: /documentation/v2/api-docs

上面的配置会将 Swagger 端点的基本路径更改为 /documentation，而无需任何重定向和其他拐杖。

遗憾的是，文档中缺少这些配置。