Swagger3-即OpenAPI访问swagger-ui.html 500问题解决

Swagger3-即OpenAPI访问swagger-ui.html 500问题解决

问题描述

1、OpenApi官网
2、根据官网步骤引入依赖

   <dependency>
      <groupId>org.springdoc</groupId>
      <artifactId>springdoc-openapi-ui</artifactId>
      <version>1.4.4</version>
   </dependency>

3、启动项目,访问 http://server:port/context-path/swagger-ui.html 该UI界面
在这里插入图片描述
启动日志报错:
在这里插入图片描述
4、问题原因:界面路径未找到。

问题解决

官网中有这么一句话:the OpenAPI description will be available at the following url for json format: http://server:port/context-path/v3/api-docs,后面这部分就是以JSON的方式展示,访问后正常展示,说明数据接口提供正常。
在这里插入图片描述
这里的解决思路是不使用依赖中自带的UI,使用github上的swagger项目的界面,并更改访问的路径为本项目的api-docs的路径。
点击进入下载地址
下载完成后将项目中的dist文件夹下的所有文件复制到resources/static/swagger下,如图所示:
在这里插入图片描述
然后修改index.html中的url,修改访问的路径。
url: “http://localhost:8087/v3/api-docs”。42行位置
在这里插入图片描述
接下来启动项目,并进入到 http://server:port/context-path/swagger/index.html。这样界面就展示出来了,如下:
在这里插入图片描述

  • 0
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
Swagger UI是一个可以可视化API资源并与之交互的工具,无需实现任何逻辑。它可以根据OpenAPI规范自动生成可视化文档,简化后端实现和客户端使用。你可以通过访问Swagger UI的界面来浏览和测试API接口。Swagger UI可以在任何开发环境中使用,无论是本地还是在Web端中。它具有人性化的设计,允许开发人员轻松地进行交互,并尝试API公开的每个操作,以方便使用。此外,Swagger UI还具有易于浏览的特点,文档归类整齐,可以快速查找和使用资源和端点。它在所有主要浏览器中都可使用,并且可以根据需要进行完全定制。Swagger UI支持Swagger 2.0或OAS 3.0中定义的API。你可以通过访问Swagger UI的中文版地址来体验它的功能。\[1\]\[2\]\[3\] #### 引用[.reference_title] - *1* [swagger-ui教程 构建api接口文档工具](https://blog.csdn.net/machihaoyu/article/details/78475699)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^insert_down28v1,239^v3^insert_chatgpt"}} ] [.reference_item] - *2* *3* [Swagger UI简介](https://blog.csdn.net/zhanshixiang/article/details/104605292)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^insert_down28v1,239^v3^insert_chatgpt"}} ] [.reference_item] [ .reference_list ]
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值