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

如何修改Swagger UI的标签页名称?(Java/Spring Boot环境)

修改Swagger UI浏览器标签页名称(Spring Boot 3.1.2 + springdoc-openapi 2.2.0)

你提到的@OpenAPIDefinition的title字段是用来定义API文档的主标题(显示在Swagger UI页面内部),并非浏览器标签页的名称。要修改标签页名称,有两种简单可行的方式:

方式1:通过配置文件直接设置

在application.properties中添加:

springdoc.swagger-ui.title=你的自定义标签页名称

或者在application.yml中:

springdoc:
  swagger-ui:
    title: 你的自定义标签页名称

启动项目后,浏览器标签页就会显示你设置的这个名称。

方式2:通过自定义配置类动态设置

如果需要根据不同环境或逻辑动态调整标签页名称,可以实现SwaggerUiConfigPropertiesCustomizer接口:

import org.springdoc.core.properties.SwaggerUiConfigProperties;
import org.springdoc.core.properties.SwaggerUiConfigPropertiesCustomizer;
import org.springframework.context.annotation.Configuration;

@Configuration
public class CustomSwaggerUiConfig implements SwaggerUiConfigPropertiesCustomizer {
    @Override
    public void customize(SwaggerUiConfigProperties swaggerUiConfigProperties) {
        // 这里可以根据业务逻辑动态设置,比如读取环境变量
        swaggerUiConfigProperties.setTitle("自定义Swagger标签页");
    }
}

启动项目后访问Swagger UI页面(默认地址是/swagger-ui.html),浏览器标签页就会显示你设置的名称。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.11 10:40:54