如何在Linux上使用Swagger UI进行调试

在Linux上使用Swagger UI进行调试，可以按照以下步骤进行：

安装Swagger UI和Swagger Editor

1. 安装Java环境：Swagger UI通常需要Java运行环境，因此首先需要在你的Linux服务器上安装Java。

sudo apt update
sudo apt install openjdk-11-jdk

2. 下载并解压Swagger UI：

wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v3.50.0.tar.gz
tar -xvf swagger-ui-3.50.0.tar.gz

3. 配置Swagger UI：

• 编辑 index.html 文件，找到以下行并进行修改：

script window.onload function () {
  const ui SwaggerUIBundle({
    url: "https://petstore.swagger.io/v2/api-docs",
    dom_id: '#swagger-ui',
    deepLinking: true,
    presets: [SwaggerUIBundle.presets.apis, SwaggerUIStandalonePreset],
    plugins: [SwaggerUIBundle.plugins.DownloadUrl],
    layout: "StandaloneLayout"
  });
  window.ui = ui;
};

4. 启动Web服务器（例如Apache或Nginx）：

• Apache：

sudo a2ensite default.conf
sudo systemctl restart apache2

• Nginx：

sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.backupsudo nano /etc/nginx/sites-available/default

修改 server 块中的 root 和 index 指令：

server {
  listen 80 default_server;
  listen [::]: 80 default_server;
  root /usr/local/nodejs;
  index index.html index.htm;
  server_name _;
  location / {
    try_files uri uri /index.html;
  }
}

保存并退出编辑器，然后重启Nginx：

sudo systemctl restart nginx

5. 访问Swagger UI：打开浏览器，访问 http://your_server_ip:8080 即可使用Swagger UI。

调试技巧

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

通过以上步骤，你就可以在Linux系统上成功部署和使用Swagger进行API测试和调试了。