温馨提示×

ubuntu postman怎么调试接口

小樊
37
2026-09-03 20:37:15
栏目: 智能运维

Ubuntu 上使用 Postman 调试接口,一般有两种方式:

  1. Postman 桌面版(推荐)
  2. Postman 网页版(Chrome/Edge)

下面以 桌面版 为例,讲清楚怎么调试接口。


一、Ubuntu 安装 Postman

方式 1:Snap 安装(最简单)

sudo snap install postman

方式 2:官网下载

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

二、创建并调试接口(基础)

1. 新建请求

  • 打开 Postman
  • 点击 + New → Request
  • 输入请求名(如 登录接口

2. 配置请求

示例(调试一个接口):

  • MethodGET / POST / PUT / DELETE
  • URL
http://localhost:8080/api/login

GET 请求

  • 参数放在 Params
username=admin
password=123456

POST 请求(JSON)

  • 选择 Body → raw → JSON
{
  "username": "admin",
  "password": "123456"
}

3. 发送请求

点击 Send

你可以看到:

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

三、常见调试技巧(很重要)

1. 设置 Header

例如:

Content-Type: application/json
Authorization: Bearer tokenxxx

2. 环境变量(多环境切换)

示例:

  • dev:http://localhost:8080
  • prod:https://api.xxx.com

设置:

  • Environments → New
  • 添加变量 base_url

请求 URL 写:

{{base_url}}/api/login

3. 查看后端错误

如果接口报错:

  • Status Code
  • Response Body
  • Ubuntu 后端日志:
tail -f logs/app.log

4. 调试本地接口

确保:

  • 后端已启动
  • 端口开放
curl http://localhost:8080/api/login

如果 curl 通,Postman 不通,可能是:

  • 代理设置
  • https / http 写错

四、Postman 控制台(调试神器)

打开:

View → Show Postman Console

可以看到:

  • 实际发送的请求
  • Header
  • 重定向
  • SSL 错误

五、常见问题(Ubuntu 特有)

1. Postman 打不开

sudo snap refresh postman

或重新安装

2. HTTPS 证书问题

Postman → Settings → SSL Certificate Verification → OFF(仅测试)


六、简单示例(POST)

POST {{base_url}}/api/login
Content-Type: application/json

{
  "username": "admin",
  "password": "123"
}

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

  • 你调试的是 什么接口(HTTP / WebSocket / gRPC)
  • 后端是 Java / Python / Node
  • 本地调试还是服务器

我可以直接帮你写 Postman 配置示例

0