温馨提示×

Ubuntu Postman API测试指南

小樊
44
2025-12-20 04:34:06
栏目: 智能运维

Ubuntu 上安装与启动 Postman

  • 使用 Snap(推荐,便于更新与管理):
    • 安装:sudo snap install postman --classic
    • 启动:在应用菜单搜索 Postman 或终端执行 postman
  • 使用 官方 Linux 压缩包(适合离线或受限环境):
    • 下载:wget https://dl.pstmn.io/download/latest/linux64 -O postman.tar.gz
    • 解压:sudo tar -xzf postman.tar.gz -C /opt/
    • 创建软链:sudo ln -s /opt/Postman/Postman /usr/local/bin/postman
    • 桌面入口(可选):创建 /usr/share/applications/postman.desktop,内容示例:
      [Desktop Entry]
      Encoding=UTF-8
      Name=Postman
      Exec=/opt/Postman/Postman
      Icon=/opt/Postman/app/resources/app/assets/icon.png
      Terminal=false
      Type=Application
      Categories=Development;
      
  • 常见问题处理:
    • 如遇依赖缺失(如 libgconf-2.so.4):sudo apt install libgconf2-4
    • 避免使用 sudo 直接启动 Postman,防止文件权限问题

快速开始一个 API 请求

  • 新建请求:点击 New → Request,命名并保存到集合(Collection)
  • 配置请求:
    • 方法:选择 GET/POST/PUT/DELETE
    • URL:输入接口地址,例如 {{baseUrl}}/users
    • 参数:在 Params 添加查询参数;在 Headers 设置如 Content-Type: application/json
    • 请求体:在 Body → raw → JSON 输入示例数据
      {
        "name": "Alice",
        "email": "alice@example.com"
      }
      
  • 发送与查看:点击 Send,在下方查看状态码、响应时间、响应头与响应体(支持 Pretty/Raw/Preview 视图)

环境变量与测试脚本

  • 环境变量:
    • 管理:右上角齿轮 → Manage Environments → Add
    • 变量示例:baseUrl=https://api.example.comtoken=xxxx
    • 使用:在 URL/Headers/Body 中以 {{baseUrl}}{{token}} 引用
  • 测试脚本(Tests):
    • 基本断言:
      pm.test("Status code is 200", () => pm.response.to.have.status(200));
      pm.test("Response has userId", () => {
        const json = pm.response.json();
        pm.expect(json).to.have.property('userId');
      });
      
    • 登录后设置变量(如 token):
      const json = pm.response.json();
      pm.environment.set("token", json.token);
      
  • 预请求脚本(Pre-request Script):常用于动态设置请求头
    pm.request.headers.add({
      key: "Authorization",
      value: "Bearer " + pm.environment.get("token")
    });
    
  • 批量运行:使用 Collection Runner 选择集合与环境,配置迭代次数与延迟,批量执行并查看结果

自动化与 CI CD 集成

  • 使用 Newman(Postman 命令行工具)运行集合:
    • 安装:npm install -g newman
    • 运行:newman run collection.json -e environment.json
  • Jenkins/GitLab CI/GitHub Actions 中执行:
    pipeline {
      agent any
      stages {
        stage('Run API Tests') {
          steps { script { sh 'newman run collection.json -e environment.json' } }
        }
      }
    }
    
  • 可结合 数据驱动监控(Monitors)Mock Server 实现覆盖更广的自动化测试与稳定性保障

常见问题与实用建议

  • 代理配置:在 Settings → General → Proxy 中配置 HTTP/HTTPS 代理;如代理需要认证,勾选 Proxy authentication 并填写凭据
  • 权限与更新:
    • 避免用 sudo 启动 Postman
    • Snap 方式可直接 sudo snap refresh postman 更新;压缩包方式需下载最新版本替换并重新创建软链
  • 团队协作:使用 团队工作区 共享集合与环境,结合 版本控制(导出 JSON 纳入 Git) 管理变更历史

0