CentOS 上 Swagger 迁移实操指南
一、迁移场景与总体策略
二、原地升级步骤 SpringFox 2.x → SpringDoc OpenAPI 3.x
<!-- 移除 -->
<!-- <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> -->
<!-- 新增 -->
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
<version>2.5.0</version>
</dependency>
// implementation "io.springfox:springfox-swagger2:3.0.0"
// implementation "io.springfox:springfox-swagger-ui:3.0.0"
implementation "org.springdoc:springdoc-openapi-starter-webmvc-ui:2.5.0"
// 旧
@Api(tags = "用户管理")
public class UserController {
@ApiOperation("创建用户")
public User create(@ApiParam("用户DTO") @RequestBody UserDTO dto){...}
}
// 新
@Tag(name = "用户管理")
public class UserController {
@Operation(summary = "创建用户", description = "根据DTO创建用户")
public User create(@Parameter(description = "用户DTO", required = true) @RequestBody UserDTO dto){...}
}
springdoc:
api-docs:
enabled: true
path: /v3/api-docs
swagger-ui:
enabled: true
path: /swagger-ui.html
三、平台迁移步骤 CentOS 原地 → Docker 或新主机
sudo yum install -y docker
sudo systemctl start docker
sudo systemctl enable docker
docker run -d -p 8080:8080 swaggerapi/swagger-editor:latest
docker run -d -p 8081:8080 swaggerapi/swagger-ui:latest
四、防火墙与网络可达性
sudo firewall-cmd --zone=public --add-port=8080/tcp --permanent
sudo firewall-cmd --zone=public --add-port=8081/tcp --permanent
sudo firewall-cmd --zone=public --add-port=3000/tcp --permanent
sudo firewall-cmd --reload
五、验证与回滚