You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Springdoc Swagger UI无法禁用Try it Out按钮问题求助

解决Springdoc UI禁用Try it Out按钮无效问题

针对Spring Boot 3.2.x + springdoc-openapi-starter-webmvc-ui 2.6.0版本,以下两种方案可解决你遇到的配置无效问题:

方案一:修正配置属性格式

Spring Boot 3.x对配置属性的大小写与分隔符要求严格,你之前使用的驼峰式属性名可能无法被正确绑定,改为kebab-case格式即可:

  • 若使用application.properties:
springdoc.swagger-ui.try-it-out-enabled=false
springdoc.swagger-ui.supported-submit-methods=
  • 若使用application.yml:
springdoc:
  swagger-ui:
    try-it-out-enabled: false
    supported-submit-methods: []

配置后重启服务,强制刷新浏览器缓存(Ctrl+F5)再验证效果。

方案二:代码方式强制覆盖配置

如果配置属性仍不生效,可通过自定义配置Bean直接覆盖Swagger UI的默认设置:

import org.springdoc.core.configuration.SpringDocUIConfiguration;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class SwaggerUiCustomConfig {

    @Bean
    public SpringDocUIConfiguration springDocUIConfiguration() {
        return SpringDocUIConfiguration.builder()
                .tryItOutEnabled(false)
                .supportedSubmitMethods(new String[0])
                .build();
    }
}

排查要点

  • 检查项目中是否存在其他自定义Swagger配置类,避免这些类的设置覆盖了当前配置。
  • 确认springdoc依赖版本与Spring Boot版本兼容,2.6.0版本确实适配Spring Boot 3.2.x,无需调整版本。

内容的提问来源于stack exchange,提问作者Cami

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.15 08:37:13