在CentOS上测试Swagger前,需安装以下基础工具:
sudo yum install java-11-openjdk-devel -y
java -version # 验证安装(需显示版本信息)
curl -sL https://rpm.nodesource.com/setup_12.x | sudo bash -
sudo yum install nodejs -y
node -v && npm -v # 验证安装
sudo yum install maven -y
mvn -version # 验证安装
Swagger UI是测试API的可视化界面,以下是两种常见部署方式:
mkdir -p /opt/swagger && cd /opt/swagger
wget https://github.com/swagger-api/swagger-ui/archive/v3.34.0.tar.gz
tar -xzf v3.34.0.tar.gz
cd swagger-ui-3.34.0
npm init -y
npm install express --save
mkdir public
cp -r dist/* public/
index.js
(指定API文档路径,如swagger.json
存放在public
目录):const express = require('express');
const app = express();
app.use('/static', express.static('public'));
app.get('/', (req, res) => res.sendFile(__dirname + '/public/index.html'));
app.listen(3000, () => console.log('Swagger UI running on port 3000'));
node index.js
浏览器打开http://<服务器IP>:3000
,即可看到Swagger UI界面。sudo yum install docker -y
sudo systemctl start docker
sudo docker pull swaggerapi/swagger-ui
sudo docker run -p 80:80 -e SWAGGER_FILE=/app/swagger.json -v /opt/swagger/docs:/app -d swaggerapi/swagger-ui
浏览器访问http://<服务器IP>
,自动加载/opt/swagger/docs/swagger.json
中的API文档。swagger.json
或swagger.yaml
文件(可通过Swagger Editor编写或从代码注释生成)。public
目录),或修改Docker挂载路径。结合自动化工具(如Postman、JUnit)实现批量测试:
swagger.json
生成测试集合,编写脚本验证响应断言(如状态码=200、返回字段包含特定值)。newman run swagger_collection.json -e swagger_env.json --reporters cli,json
Access-Control-Allow-Origin: *
)。通过以上步骤,可在CentOS上完成Swagger的部署与API测试,覆盖从文档查看、手动调试到自动化验证的全流程。