如何为OpenApi的/swagger-ui路径添加自定义前缀且不修改全局context-path

错误配置原因 #

你之前的springdoc.swagger-ui.path配置了classpath资源路径，该配置项的作用是定义swagger-ui的访问路由，而非静态资源存储地址，因此不会生效。

可行配置方案 #

仅需修改swagger相关的路由前缀，不会影响业务接口的路由规则，符合你不修改全局context-path的需求，配置如下：

springdoc:
  swagger-ui:
    # 定义swagger-ui的访问路径
    path: /application-service/swagger-ui
    # 指定swagger-ui加载OpenAPI定义的请求地址，和下方api-docs.path保持一致
    url: /application-service/v3/api-docs
  api-docs:
    # 定义OpenAPI原始数据的访问路径
    path: /application-service/v3/api-docs

配置验证 #

项目启动后：

• 先访问http://localhost:8080/application-service/v3/api-docs，确认可以正常返回OpenAPI的JSON结构
• 再访问http://localhost:8080/application-service/swagger-ui即可正常打开接口文档页面

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