Postman在Ubuntu上如何进行验收测试

在 Ubuntu 上使用 Postman 进行验收测试

一 环境准备与安装

• 使用 Snap（推荐）：sudo snap install postman --classic
• 使用 APT：
  • wget -qO - https://dl.postman.co/postman.gpg | sudo apt-key add -
  • echo “deb https://dl.postman.co/debian $(lsb_release -cs) main” | sudo tee /etc/apt/sources.list.d/postman.list
  • sudo apt update && sudo apt install postman
• 使用 Flatpak：
  • sudo apt install flatpak
  • flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
  • flatpak install flathub com.postman.Postman
• 也可手动安装：下载 Linux x64 包，解压至 /opt，并创建软链 sudo ln -s /opt/Postman/Postman /usr/local/bin/postman，随后可通过应用菜单或命令行启动 Postman。

二 验收测试设计要点

• 明确验收范围：覆盖核心业务流、关键状态码、响应结构、性能边界、错误场景与安全约束。
• 准备测试数据：使用 Environment/Global 管理不同环境（如 dev/staging/prod）的变量（如 baseUrl、token），在请求与脚本中引用，便于复用与切换。
• 组织测试资产：将相关请求放入 Collection，为接口与场景建立清晰的层级与命名，便于批量运行与维护。
• 验收判定标准：为每个用例定义可度量的断言与阈值（如 200/201、必填字段、字段类型/范围、响应时延上限、错误码与消息规范）。

三 在 Postman 中编写验收断言

• 状态码与状态名：
  • pm.test(“Status code is 200”, () => pm.response.to.have.status(200));
  • pm.test(“Status name has Created”, () => pm.expect(pm.response.code.name).to.include(“Created”));
• 响应体内容：
  • 精确匹配：tests[“Body equals”] = responseBody === “expected”;
  • 子串匹配：tests[“Body contains”] = responseBody.has(“keyword”);
• JSON 结构与值：
  • const json = pm.response.json();
  • pm.test(“Field equals”, () => pm.expect(json.id).to.eql(123));
  • 可结合 to.be.a、to.have.property、to.include.members 等做结构与集合校验。
• 响应时间：pm.test(“Response time < 200ms”, () => pm.expect(pm.response.responseTime).to.be.below(200));
• 响应头：pm.test(“Content-Type is JSON”, () => pm.expect(pm.response.headers.get(“Content-Type”)).to.include(“application/json”));
• 变量与链路：在 Tests 中设置变量供后续请求使用，例如 postman.setEnvironmentVariable(“authToken”, json.token);
• XML 响应：使用 const json = xml2Json(responseBody); 转为 JSON 后按路径断言。

四 运行与批量执行

• 在图形界面运行：打开 Runner，选择目标 Collection 与环境，配置迭代次数与数据文件，点击 Start Run 查看每个请求的 Test Results 与整体通过率，用于本地回归与演示。
• 命令行自动化：使用 Newman 在 Ubuntu 终端或 CI 中执行。
  • 安装：npm install -g newman
  • 运行：newman run your_collection.json --environment your_env.json
  • 报告：可生成 HTML/JSON 报告（如 --reporters cli,html,json），便于留存与审计。

五 验收通过标准与示例

• 验收通过标准示例
  • 功能正确性：状态码为 200/201；必填字段存在且类型正确；关键业务字段值符合约束；列表/分页结构正确。
  • 一致性与兼容性：响应头 Content-Type 正确；错误场景返回规范的错误码与消息；时间格式与数值精度统一。
  • 性能与稳定性：P95 响应时延不超过 200 ms（按业务约定）；在 Runner/Newman 多次迭代下无内存泄漏或异常退出。
  • 安全与合规：鉴权信息不泄露；仅返回必要字段；对非法输入返回 4xx 且不暴露内部细节。
• 示例集合与脚本
  • 场景：获取用户信息
    • 请求：GET {{baseUrl}}/users/{{userId}}，Headers: Authorization: Bearer {{authToken}}
    • Tests:
      • pm.test(“Status 200”, () => pm.response.to.have.status(200));
      • const json = pm.response.json();
      • pm.test(“Has id and name”, () => { pm.expect(json).to.have.property(“id”).that.is.a(“number”); pm.expect(json).to.have.property(“name”).that.is.a(“string”); });
      • pm.test(“Response time < 200ms”, () => pm.expect(pm.response.responseTime).to.be.below(200));
  • 运行命令：newman run user-api.json -e staging.json --reporters cli,html。