# swagger3 关闭配置（快捷方式）
## 配置参考
```yaml
springfox:
  documentation:
    # 总开关（同时设置auto-startup=false，否则/v3/api-docs等接口仍能继续访问）
    enabled: false
    auto-startup: false
    swagger-ui:
      enabled: false
```
## 配置原理
```
<dependency>
		<groupId>io.springfox</groupId>
		<artifactId>springfox-boot-starter</artifactId>
</dependency>
```
springfox.boot.starter.autoconfigure.OpenApiAutoConfiguration
springfox.boot.starter.autoconfigure.SpringfoxConfigurationProperties
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-1558800/6eed886b8c2f1b7d99bde4d1f7aec3ef.png)
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-1558800/7c7974396babd82ade0dc730395a5740.png)


# swagger2 关闭配置
swagger2 关闭主要是根据条件使swagger 配置不再生效，如
##  方法一：@ConditionalOnProperty
```java
Configuration
@EnableSwagger2
@ConditionalOnProperty(name = "swagger.enable", havingValue = "true")
public class Swagger2 extends WebMvcConfigurationSupport {
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                //为当前包路径
                .apis(RequestHandlerSelectors.basePackage("com.yq.demo.controller"))
                .paths(PathSelectors.any())
                .build();
    }
    //构建 api文档的详细信息函数,注意这里的注解引用的是哪个
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("Spring Boot 测试使用 Swagger2 构建RESTful API")
                .contact(new Contact("java乐园", "https://xxx.com", "test@163.com"))
                .version("1.0")
                .description("User API 描述")
                .build();
    }
 
    @Override
    protected void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/swagger-ui.html").addResourceLocations(
                "classpath:/META-INF/resources/");
        registry.addResourceHandler("/webjars/**").addResourceLocations(
                "classpath:/META-INF/resources/webjars/");
    }
}
```
application.yml 中配置如下关闭:
```yml
swagger:
  # 只要不是true就不启用
  enable: false
```
>其他基于Conditional的方式
## 方法二 @Profile
原理跟第一个差不多，只是判断条件不同（profile判断配置文件，也即的参数）
```java
Configuration
@EnableSwagger2
@Profile("!prod")
public class Swagger2 extends WebMvcConfigurationSupport {
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                //为当前包路径
                .apis(RequestHandlerSelectors.basePackage("com.yq.demo.controller"))
                .paths(PathSelectors.any())
                .build();
    }
    //构建 api文档的详细信息函数,注意这里的注解引用的是哪个
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("Spring Boot 测试使用 Swagger2 构建RESTful API")
                .contact(new Contact("java乐园", "https://xxx.com", "test@163.com"))
                .version("1.0")
                .description("User API 描述")
                .build();
    }
 
    @Override
    protected void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/swagger-ui.html").addResourceLocations(
                "classpath:/META-INF/resources/");
        registry.addResourceHandler("/webjars/**").addResourceLocations(
                "classpath:/META-INF/resources/webjars/");
    }
}
```
## 方法三 @Value 配置Docket 失效办法
```java
Configuration
@EnableSwagger2
public class Swagger2 extends WebMvcConfigurationSupport {

	@Value("{swagger2.enable:false}")
    private boolean enableSwagger;

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
				.enable(enableSwagger)
                .select()
                //为当前包路径
                .apis(RequestHandlerSelectors.basePackage("com.yq.demo.controller"))
                .paths(PathSelectors.any())
                .build();
    }
    //构建 api文档的详细信息函数,注意这里的注解引用的是哪个
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("Spring Boot 测试使用 Swagger2 构建RESTful API")
                .contact(new Contact("java乐园", "https://xxx.com", "test@163.com"))
                .version("1.0")
                .description("User API 描述")
                .build();
    }
 
    @Override
    protected void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/swagger-ui.html").addResourceLocations(
                "classpath:/META-INF/resources/");
        registry.addResourceHandler("/webjars/**").addResourceLocations(
                "classpath:/META-INF/resources/webjars/");
    }
}
```

springfox.boot.starter.autoconfigure.OpenApiAutoConfigurationspringfox.boot.starter.autoconfigure.SpringfoxConfigurationProperties

【swagger关闭】生产环境关闭swagger方法

高级技术架构师

后端

开发工具

详解Swagger2和Swagger3关闭配置方法，包括YAML配置、条件注解和依赖管理。提供多种关闭方案：通过@ConditionalOnProperty、@Profile条件注解控制，或使用@Value动态配置。适用于不同Spring Boot环境下的Swagger接口文档管理需求。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

【swagger关闭】生产环境关闭swagger方法-腾讯云开发者社区-腾讯云

【swagger关闭】生产环境关闭swagger方法

【swagger关闭】生产环境关闭swagger方法

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐