Swagger 3.0.0：没有 SwaggerConfig 和 @Profile 无法在生产中禁用

Question

我正在从 2.x 升级到 SpringFox Swagger 3.0.0，它引入了 Spring Boot 启动器 springfox-boot-starter 依赖项，从而消除了对基于 2.x 的 SwaggerConfig 的需求：

/**
 * NO LONGER NEEDED
 */
@Configuration
@EnableSwagger2
@Profile({"local", "dev", "beta"}) // <- HOW TO DISABLE IN PROD INSTEAD OF THIS
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.any())
                .build();
    }
}

现在我不再需要这个@Configuration，它允许我在@Profile 中指定我的环境配置文件并因此在生产中禁用Swagger，我如何在SpringFox Swagger-UI 3.x 中禁用生产中的Swagger？

注意：讨论了基于 Spring Security 的方法here，这对于某些人来说可能是一种选择，但对于这种情况不是一种选择，原因有两个：

• 我的应用程序没有使用 Spring Security，并且无法包含 spring-boot-security-starter 依赖项
• 它需要将所有其他端点列入白名单才能让它们再次工作，这是不可接受的

Answer 1

答案并不容易找到，并且不在 SpringFox 的迁移指南或文档 here 中（应该在哪里）。

Swagger UI 3.0.0 的正确且迄今为止最好的答案是here。

只需将springfox.documentation.enabled=[true|false] 添加到目标环境的application.properties 或application.yml 即可。

顺便说一句，很高兴看到 SpringFox 文档中列出的所有可用 Spring Boot 属性列表的部分。