Ubuntu下Swagger调试技巧有哪些 - 问答

在Ubuntu下使用Swagger进行调试，可以遵循以下步骤和技巧：

安装Node.js和npm：

sudo apt update
sudo apt install -y nodejs npm

下载并启动Swagger Editor：
- 访问Swagger Editor GitHub发布页面，下载最新版本的Swagger Editor。
- 解压并启动Swagger Editor：
```
wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v3.16.1.tar.gz
tar -xvf v3.16.1.tar.gz
cd swagger-editor-3.16.1
npm install
npm install -g http-server
http-server -p 8080
```
- 现在，你可以在浏览器中访问 http://localhost:8080 来使用Swagger Editor。
下载并启动Swagger UI：
- 访问Swagger UI GitHub发布页面，下载最新版本的Swagger UI。
- 解压并启动Swagger UI：
```
wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v3.48.0.tar.gz
tar -xvf v3.48.0.tar.gz
cd swagger-ui-3.48.0
npm install
npm install -g http-server
http-server -p 8081
```
- 现在，你可以在浏览器中访问 http://localhost:8081 来使用Swagger UI。

Swagger Editor：默认情况下，Swagger Editor会加载 https://petstore.swagger.io/v2/swagger.json。你可以通过编辑 index.html 文件来更改默认的Swagger规范文件路径。
Swagger UI：在Swagger UI中，你可以通过输入框来输入你的Swagger规范文件（通常是 swagger.yaml 或 swagger.json）的URL，然后点击“Explore”按钮来加载和测试你的API接口。

在Swagger Editor中导入Swagger规范文件：
- 打开Swagger Editor后，点击“File” - “Import” - “Open File”，然后选择你的 swagger.yaml 或 swagger.json 文件。
在Swagger UI中测试API接口：
- 在Swagger UI中，选择你要测试的API接口，点击“Try it out!”按钮，然后在弹出的对话框中输入必要的参数，最后点击“Execute”按钮来测试接口。

自定义JavaScript脚本：在Swagger UI的 wwwroot/swagger-ui/ 目录下创建一个 custom.js 文件。在这个文件中，你可以编写自定义函数（例如 authorizeSwagger），用于在获取token后自动授权Swagger。
静态文件服务：确保你的应用正确地启用了静态文件服务，以便Swagger UI能够正常加载所有必要的文件。
JavaScript注入：使用InjectJavascript机制将你的 custom.js 脚本注入到Swagger UI中间件中，实现自动授权等功能。

通过以上步骤和技巧，你可以在Ubuntu上成功安装、配置和使用Swagger进行API调试和性能优化。如果在安装过程中遇到问题，可以参考相关的官方文档或社区论坛寻求帮助。

0 赞

0 踩