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

SpringBoot项目Swagger-UI加载swagger-config失败的重定向配置问题

解决SpringDoc Swagger-UI请求swagger-config路径错误的问题

你的问题核心是Swagger-UI默认请求的swagger-config路径多了/services前缀,需要调整配置指向正确路径,具体方案如下:

  1. 明确配置属性作用

    • springdoc.swagger-ui.path是用来设置Swagger-UI页面本身的访问路径(比如你当前的/swagger-ui/index.html),这个属性不需要修改,你的问题和它无关。
    • 真正需要配置的是springdoc.swagger-ui.config-url,它用来指定Swagger-UI获取swagger-config文件的地址。
  2. application.yaml配置示例
    在你的Spring Boot项目的application.yaml中添加以下配置:

    springdoc:
      swagger-ui:
        config-url: /v3/api-docs/swagger-config
    
  3. 配置说明
    配置后,Swagger-UI会直接向http://exampleadress.com/v3/api-docs/swagger-config请求配置文件,正好匹配你实际的swagger-config路径。如果后续你的API文档基础路径有变动,只需要同步修改config-url的值即可。

  4. 验证
    重启项目后访问Swagger-UI页面,打开浏览器开发者工具查看网络请求,确认swagger-config的请求地址已经变为正确路径即可。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.08 18:03:12