楔子

Swagger 是 Java Web 开发中常用的接口文档生成类库，在开发和前后端联调时使用它来模拟接口调用能提高开发效率。但是，在生产环境可能并不需要它，一个原因是启用它会延长程序启动时间（动态解析代码中的注解来生成文档），另一个是安全问题（过不了漏洞扫描，需要鉴权访问或禁用掉）

本文的目标就是禁用掉 Swagger，由于配置比较简单，笔者在本地已经实践通过了，直接记录在这里了。

笔者测试版本基于 SpringBoot 2.4.6 + io.springfox:springfox-swagger2:3.0.0

禁用方法

yaml 配置方式：

springfox:
  documentation:
    auto-startup: false

properties 配置方式：

springfox.documentation.auto-startup=false

最佳实践

说是最佳实践，其实是相对而言的。即通过SpringBoot的 配置覆盖/多环境配置文件 来实现。

配置文件覆盖

在默认的配置文件 application.{yaml|properties} 中添加禁用配置，然后在具体环境配置文件中覆盖它。

比如，开发测试环境有个 application-dev.properties，在这个配置文件里可以设置开启

springfox.documentation.auto-startup=true

生产环境什么也不配置，走默认 application.properties(含禁用配置) 即禁用Swagger。

多环境配置文件

比如开发测试配置文件是 application-dev.properties，生产配置文件是 application-prod.properties，就可以只在 application-prod.properties 中添加禁用配置。

以上两种方式都可以，看大家想使用哪种了。

本文同步于本人博客园(hellxz.cnblogs.com) 与 CSDN(https://blog.csdn.net/u012586326)，禁止转载。