Java Spring Boot OpenAPI Swagger UI页面顶部入口字段配置修改方法

一、判断正确性确认 #

你的判断完全正确，Swagger UI顶部显示的该字段就是当前接口文档全局统一的根请求路径前缀，所有当前分组下的接口都会拼接该前缀作为完整请求地址。

二、字段取值修改方式 #

你已经定位到了配置来源，直接按以下步骤操作即可：

• 直接修改application.yaml中对应配置项的取值即可，示例如下（如需修改为v2版本）：

spring:
  application:
    ...
    api-version: "v2"

• 若修改后未生效，请额外排查两个点位：
  • 确认项目的Swagger配置类中，已正确读取该配置字段注入到全局路径前缀属性，常见注入写法为@Value("${spring.application.api-version}")，确保配置读取逻辑无误。
  • 修改配置后需要重启Spring Boot项目，新的配置才会同步到Swagger UI页面生效。

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