如何修改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
相关产品推荐
相关产品推荐

