温馨提示×

debian swagger如何升级

小樊
33
2026-09-10 16:25:25
栏目: 智能运维

在 Debian 系统上“升级 Swagger”要分情况,因为 Swagger 不是一个单独的 Debian 软件包,而是通常以不同形式存在。下面按常见场景说明:


一、如果你指的是 Swagger UI / Swagger Editor(前端静态项目)

1. 通过 npm 安装/升级

# 查看当前版本
npm list swagger-ui swagger-ui-express

# 升级
npm install swagger-ui@latest
npm install swagger-ui-express@latest

2. 手动替换静态文件

如果是直接下载的 swagger-ui

cd /var/www/swagger-ui
rm -rf *
wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v5.x.x.tar.gz
tar -xzf v5.x.x.tar.gz

二、如果你在 Spring Boot / Java 项目中使用 Swagger

1. 旧版 Swagger(springfox)

<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger2</artifactId>
  <version>3.0.0</version>
</dependency>

2. 推荐升级到 SpringDoc(Swagger 3 / OpenAPI)

<dependency>
  <groupId>org.springdoc</groupId>
  <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
  <version>2.5.0</version>
</dependency>

访问地址:

/swagger-ui.html

三、如果你用的是 Swagger Codegen / OpenAPI Generator

升级 Codegen

npm install -g @openapitools/openapi-generator-cli

brew upgrade openapi-generator

四、Debian 系统层面的注意事项

  • Debian 官方仓库没有 swagger 包
  • 不要试图用 apt upgrade swagger(不存在)
  • 确保 Node / Java 版本满足新 Swagger 要求

五、如何确认你当前用的是哪种 Swagger?

可以告诉我:

  1. 是 Web 页面?还是代码依赖?
  2. 用的语言(Node / Java / Python)
  3. 访问路径(如 /swagger-ui.html

我可以给你精确的升级步骤

0