34

我正在运行一项服务，可通过以下方式访问 Swagger UI：

http://serviceURL/swagger-ui.html

但是，它位于代理后面，例如：

http://proxyURL/serviceName

Swagger UI 生成的 URL 如下所示：

http://proxyURL/

而不是以 serviceName 作为后缀的实际 URL。据我所知，这意味着操纵 basePath 属性。根据文档：

swagger API 文档不能再描述不同基本路径上的操作。在 1.2 和更早版本中，每个资源都可以有一个单独的 basePath。在 2.0 中，为整个规范定义了 basePath 等效项（schemes+host+basePath）。

@Api(basePath) 已弃用，它没有说明使用什么以及如何使用它。如何让 Swagger 生成的路径正确显示？

我正在使用Spring Boot、Springfox Swagger和注释。

4

3 回答 3

16 
@Bean
public Docket newsApi(ServletContext servletContext) {
    return new Docket(DocumentationType.SWAGGER_2).pathProvider(new RelativePathProvider(servletContext) {
        @Override
        public String getApplicationBasePath() {
            return "/serviceName" + super.getApplicationBasePath();
        }
    }).host("proxyURL");
}
于 2017-04-16T15:11:35.113 回答
4

您可以像这样编辑SwaggerConfiguration：

注意替换package（需要是包含您的 REST 控制器的那个）host、 和PATH您需要的

@Configuration
@EnableSwagger2
public class SwaggerConfiguration implements WebMvcConfigurer {

    public static final String PATH = "/serviceName";

    @Bean
    public Docket api() {
        final var package = "com.martin.rest";
        final var host = "localhost:8080";

        return new Docket(DocumentationType.SWAGGER_2)
                .host(host)
                .select()
                .apis(RequestHandlerSelectors.basePackage(package))
                .paths(PathSelectors.any())
                .build();
    }

    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        final var apiDocs = "/v2/api-docs";
        final var configUi = "/swagger-resources/configuration/ui";
        final var configSecurity = "/swagger-resources/configuration/security";
        final var resources = "/swagger-resources";

        registry.addRedirectViewController(PATH + apiDocs, apiDocs).setKeepQueryParams(true);
        registry.addRedirectViewController(PATH + resources, resources);
        registry.addRedirectViewController(PATH + configUi, configUi);
        registry.addRedirectViewController(PATH + configSecurity, configSecurity);
        registry.addRedirectViewController(PATH, "/");
    }

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler(PATH + "/**").addResourceLocations("classpath:/META-INF/resources/");
    }
}

另一种解决方案是更改 spring-boot URL context-path：

编辑浇筑application.properties文件：

server.servlet.context-path=/serviceName

或者，如果您有application.yml文件：

server:
  servlet:
    context-path: /serviceName

警告：它会改变你所有 Web 服务的基本路径，而不仅仅是 Swagger

于 2020-04-07T15:52:42.050 回答
4

使用spring fox 2.9.2，使用其他用户提到的解决方案是行不通的。

什么不起作用：

  • 在 Docket pathProvider 上覆盖 getApplicationBasePath
  • 添加 server.servlet.context-path=/serviceName

我不知道为什么它们不起作用，但是在我使用 Springboot 2.1.6.RELEASE 和 Spring 5.1.8.RELEASE 的项目中，上面的两个解决方案被忽略了。

所以，我正在尝试另一种方法：https ://github.com/springfox/springfox/issues/2817#issuecomment-517753110

根据 github 问题评论，我需要覆盖 Springfox json 序列化类，感谢上帝这有效。这是代码示例：

import io.swagger.models.Swagger;
import org.springframework.context.annotation.Primary;
import org.springframework.core.env.Environment;
import org.springframework.stereotype.Component;
import springfox.documentation.spring.web.json.JacksonModuleRegistrar;
import springfox.documentation.spring.web.json.Json;
import springfox.documentation.spring.web.json.JsonSerializer;

import java.util.Arrays;
import java.util.List;

import static io.github.jhipster.config.JHipsterConstants.SPRING_PROFILE_PRODUCTION;

@Component
@Primary
public class CustomBasePathSerialize extends JsonSerializer {

    // this injection is optional, if you don't need to
    // add basePath based on active profile, remove this.
    private final Environment env;

    public CustomBasePathSerialize(List<JacksonModuleRegistrar> modules,
                                   Environment env) {
        super(modules);
        this.env = env;
    }

    @Override
    public Json toJson(Object toSerialize) {
        if (toSerialize instanceof Swagger) {
            Swagger swagger = (Swagger) toSerialize;
            String basePath = "/serviceName";
            List<String> profiles = Arrays.asList(env.getActiveProfiles());

            // OPTIONAL: you can change basePath if you have difference path 
            // on any Spring profile, for example prod:
            if (profiles.contains(SPRING_PROFILE_PRODUCTION)) {
                basePath = "/";
            }
            swagger.basePath(basePath);
        }
        return super.toJson(toSerialize);
    }
}
于 2020-05-31T02:42:16.620 回答