温馨提示×

linux swagger怎样更新

小樊
46
2026-09-27 19:18:22
栏目: 智能运维

在 Linux 下“更新 Swagger”通常有几种不同场景,下面按最常见情况给你说明,你可以对照自己的使用方式:


一、如果你用的是 Spring Boot + Swagger(最常用)

1️⃣ 更新 Swagger 版本(Maven)

修改 pom.xml:

<!-- 老版本 Swagger 2 -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>3.0.0</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>3.0.0</version>
</dependency>

✅ 推荐(新项目)使用 SpringDoc(Swagger 3)

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

然后重新构建:

mvn clean package
java -jar your-app.jar

访问:

http://localhost:8080/swagger-ui.html

二、如果你是用 Docker 部署的 Swagger UI

更新 Swagger UI 容器

docker pull swaggerapi/swagger-ui
docker stop swagger-ui
docker rm swagger-ui
docker run -d -p 8080:8080 \
  -e SWAGGER_JSON=/foo/swagger.json \
  -v $(pwd)/swagger.json:/foo/swagger.json \
  --name swagger-ui swaggerapi/swagger-ui

三、如果你是用 Node / npm 安装的 swagger

npm update swagger-ui-express
# 或
npm install swagger-ui-express@latest

重启服务:

pm2 restart app
# 或
node app.js

四、如果你是更新接口文档(不是升级软件)

只需要:

  • 修改代码中的注解(@Api、@Operation 等)
  • 重新启动服务
  • 浏览器刷新 Swagger 页面(建议 Ctrl+F5)

五、Linux 系统级更新(不常见)

如果你指的是系统包:

sudo apt update
sudo apt upgrade

✅ 快速判断你属于哪种

你可以告诉我:

  1. 用的是 Spring Boot / Node / Docker / 其他?
  2. 是升级 Swagger 版本还是更新接口文档?

我可以给你更精确的命令。

0 踩