怎样测试linux swagger接口

在 Linux 下“测试 Swagger 接口”通常有两层意思：

本地验证 Swagger 文档是否可用
通过 Swagger 提供的接口（OpenAPI）发起接口测试

下面从最常见、最实用的角度一步步讲。

一、确认 Swagger / OpenAPI 文档地址

不同框架路径不同，常见如下：

Spring Boot

http://IP:端口/swagger-ui.html
http://IP:端口/v3/api-docs

SpringDoc
```
http://IP:端口/swagger-ui/index.html
```
FastAPI
```
http://IP:端口/docs
```
Node / NestJS
```
http://IP:端口/api/docs
```

先确认文档能打开。

二、用 curl 直接测试接口（最常用）

1️⃣ 获取接口列表（OpenAPI JSON）

curl http://127.0.0.1:8080/v3/api-docs

你会看到所有接口定义。

2️⃣ 直接调用某个接口

例如 Swagger 里有一个：

POST /api/login

curl -X POST http://127.0.0.1:8080/api/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"123456"}'

3️⃣ 带 Token 测试

curl http://127.0.0.1:8080/api/user/info \
  -H "Authorization: Bearer xxxxx"

三、用 Swagger UI 页面测试（图形化）

如果 Linux 有桌面或你可以端口转发：

ssh -L 8080:127.0.0.1:8080 user@linux-server

浏览器打开：

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

点击 Try it out → Execute

四、用 swagger-cli / openapi 工具测试

安装

npm install -g swagger-cli

校验文档

swagger-cli validate http://127.0.0.1:8080/v3/api-docs

五、用 Postman / Newman（Linux 命令行）

导出 Swagger JSON

http://IP:端口/v3/api-docs

用 Newman 跑测试

newman run swagger.json

六、常见问题排查

✅ 接口 404

路径不对
Swagger 未启用

✅ 无法访问

curl -v http://IP:端口

检查防火墙、端口监听：

netstat -tunlp | grep 8080

✅ 需要内网访问
用 SSH 端口转发最有效。

七、推荐测试流程（实战）

curl 验证 Swagger JSON
curl 直接测接口
Swagger UI 做复杂参数测试
Postman / 自动化脚本做回归

如果你愿意，可以告诉我：

使用的语言/框架（Spring / FastAPI / Node）
是否只有命令行环境
是否要做自动化测试

我可以直接给你针对性的命令或脚本。