温馨提示×

ubuntu postman如何调试

小樊
33
2026-07-12 01:47:47
栏目: 智能运维

Ubuntu 上用 Postman 调试接口,常见使用方式和调试技巧如下:


一、Ubuntu 上安装 Postman

方式 1:Snap(推荐)

sudo snap install postman

方式 2:官网下载

  1. 打开 https://www.postman.com/downloads/
  2. 下载 Linux 版本
  3. 解压并运行:
tar -xzf Postman-linux-x64-*.tar.gz
cd Postman
./Postman

二、基本调试流程

1️⃣ 创建请求

  • 打开 Postman
  • 点击 New → HTTP Request
  • 选择请求方式:GET / POST / PUT / DELETE
  • 填写 URL(如 http://localhost:8080/api/test

2️⃣ 设置请求参数

Query 参数

http://example.com/api?page=1&size=10

或在 Params 中填写

Headers

常见调试 Header:

Content-Type: application/json
Authorization: Bearer token

Body(POST / PUT)

  • raw → JSON
{
  "username": "test",
  "password": "123456"
}

三、常用调试技巧

✅ 1. 查看响应信息

发送请求后,检查:

  • Status Code(200 / 400 / 500)
  • Response Body
  • Response Headers
  • Time / Size

✅ 2. 使用 Console 调试(非常重要)

打开 Postman Console:

  • 快捷键:Ctrl + Alt + C
  • 或菜单:View → Show Postman Console

可以看到:

  • 实际发送的请求
  • 请求 headers / body
  • 错误信息

接口没反应、404、CORS 问题,先看 Console


✅ 3. 调试环境变量

适合多环境(dev / test / prod)

{{base_url}}/api/login

设置变量:

  • Environments → Add
  • 变量示例:
base_url = http://localhost:8080

✅ 4. 使用 Pre-request Script

在请求发送前执行 JS:

console.log("准备发送请求");
pm.environment.set("token", "abc123");

✅ 5. 使用 Tests 验证返回结果

pm.test("状态码是 200", function () {
    pm.response.to.have.status(200);
});

pm.test("返回数据包含 token", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.token).to.exist;
});

四、常见调试问题(Ubuntu)

❌ 1. 请求 localhost 失败

  • 确认服务已启动
  • 防火墙未拦截
  • 使用 127.0.0.1 而不是 localhost

❌ 2. CORS 问题

  • CORS 是 后端问题
  • Postman 不受浏览器 CORS 限制
  • 如果浏览器报错但 Postman 正常,问题在后端

❌ 3. 无法访问 HTTPS

  • 关闭 SSL 校验(调试用):
Settings → General → SSL certificate verification → OFF

五、结合后端调试建议

  • 后端打印请求日志
  • 使用 curl 对比:
curl -X POST http://localhost:8080/api/login \
-H "Content-Type: application/json" \
-d '{"user":"test"}'

如果你愿意,可以告诉我:

  • 调试的是 REST API / WebSocket / gRPC
  • 后端语言(Java / Node / Python)?
  • 具体报错(状态码 / 报错信息)

我可以给你更针对性的调试方案 ✅

0