Swagger无Authorization按钮，本地正常部署后丢失如何排查解决？

前置说明 #

你提供的Swagger配置本身逻辑正确，本地可正常显示Authorization按钮说明配置代码没有问题，故障由线上和本地的环境差异导致，可按照以下步骤排查修复。

排查步骤 #

• 检查Swagger配置类加载范围：查看SwaggerConfig类上是否标注了@Profile、@Conditional等条件注解，限制了仅在开发/测试环境初始化该配置，线上环境不会加载Security相关配置。可查看服务启动日志确认Docket Bean是否正常初始化，也可直接请求线上/v2/api-docs接口，检查返回的JSON中是否存在securityDefinitions字段，无该字段则说明安全配置未生效。
• 检查反向代理/网关配置：线上通常会使用Nginx、API网关做请求转发，检查是否有规则过滤了/v2/api-docs的返回内容，或者截断了Swagger的静态资源。可在浏览器按F12打开开发者工具，查看控制台是否有静态资源加载报错，对比线上和本地/v2/api-docs的返回内容是否完全一致。
• 检查依赖版本一致性：确认本地和线上打包使用的Swagger相关依赖（springfox-swagger2、springfox-swagger-ui）版本完全一致，排查线上打包时是否存在依赖冲突，或者Swagger相关依赖被exclude的情况。
• 检查权限拦截规则：查看Spring Security、自定义拦截器的配置，是否拦截了/v2/api-docs、/swagger-resources/**等Swagger核心接口，导致返回的接口文档信息被阉割，缺少安全相关配置。
• 检查Swagger开关配置：确认项目配置文件中是否有swagger.enabled之类的开关参数，线上环境是否将该参数设为false，导致Swagger仅加载基础配置，不加载安全相关规则。

修复方案 #

• 调整配置类加载范围：如果SwaggerConfig加了环境限制注解，可将线上环境加入生效范围，或删除条件注解（注：线上暴露Swagger存在安全风险，建议先评估风险，尽量仅在内网开放）。
• 修正反向代理规则：在Nginx、网关配置中放行所有Swagger相关路径，包括/swagger-ui.html、/webjars/**、/swagger-resources/**、/v2/api-docs，禁止修改/v2/api-docs的返回内容。
• 锁定依赖版本：在项目依赖管理中明确指定Swagger相关依赖的版本，避免版本冲突，例如固定springfox版本为2.9.2等稳定版本。
• 放行Swagger路径白名单：在权限拦截配置中，将所有Swagger相关路径加入免校验白名单，确保/v2/api-docs能返回完整的文档配置。
• 强制开启Swagger配置：可在Docket初始化代码中追加.enable(true)参数，强制Swagger在当前环境生效，避免配置开关的影响。

安全提示：线上环境开放Swagger会泄露接口信息，容易被恶意攻击，建议开启Swagger页面的登录校验，或者仅在内网环境开放Swagger访问权限。

内容的提问来源于stack exchange，提问作者SonYoonSeok