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

Spring Boot集成OpenAPI/Swagger时Swagger UI加载极慢或无法加载的问题求助

Spring Boot集成OpenAPI/Swagger时Swagger UI加载极慢或无法加载的问题求助

各位大佬好,我最近碰到个特别头疼的问题:在Spring Boot项目里用SpringDoc集成OpenAPI后,/v3/api-docs接口加载速度还算正常,不到5秒就能返回结果,但一访问/swagger-ui.html页面,加载速度慢得离谱,要等好久好久才能出来,实在搞不懂哪里出问题了,求帮忙分析下!

我的SpringDoc配置

springdoc:
  api-docs:
    enabled: true
    version: openapi_3_1
    path: /v3/api-docs
  swagger-ui:
    enabled: true
    path: /swagger-ui.html
    url: /v3/api-docs
    operations-sorter: method
    config-url: ${RESOURCE_SERVER_PREFIX}/swagger-config
  show-actuator: false
  enable-kotlin: true
  enable-spring-security: true
  enable-default-api-docs: true
  default-produces-media-type: application/json

具体问题表现

  • /v3/api-docs接口:加载正常,耗时小于5秒,能正常返回OpenAPI的规范JSON
  • /swagger-ui.html页面:
    1. 刚访问时,页面只显示Swagger UI的logo,中间有持续转圈的加载动画,整个页面几乎是空白状态,没有任何API相关内容
    2. 这个加载状态要持续很长时间,我得一直等一直等
    3. 等了很久之后,才能看到完整加载完成的Swagger UI界面,显示出所有的API分组和操作列表

备注:内容来源于stack exchange,提问作者Sachin

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.04.15 11:54:48