用命令行做测试：结合 curl 和 jq 实现接口自动验证

最新推荐文章于 2025-07-22 17:59:31 发布

原创最新推荐文章于 2025-07-22 17:59:31 发布 · 772 阅读

11 ·

CC 4.0 BY-SA版权

文章标签：

#软件测试 #人工智能 #Postman #接口测试 #curl #智能化测试 #软件开发和测试

智能化测试同时被 3 个专栏收录

121 篇文章

订阅专栏

接口测试

18 篇文章

订阅专栏

DevOps

14 篇文章

订阅专栏

在当今的敏捷开发与DevOps环境中，接口测试（API Testing）已成为质量保障的核心支柱。尽管许多团队采用 Postman、SoapUI 或自动化测试框架如 RestAssured，但在实际工作中，一个被严重低估却极为高效的方式是——直接使用命令行工具 curl 与 jq 组合进行接口验证。

这种方式具有：

零依赖、跨平台：只需 shell 环境；
高效自动化：可嵌入 CI/CD 脚本；
调试友好：测试与排查融为一体；
低学习曲线：掌握后可快速上手并扩展。

本文将系统性剖析如何使用 curl + jq 构建轻量级、可自动化的接口测试流程，覆盖核心命令、实践技巧、自动验证模型与脚本化案例，让你在无需复杂工具的前提下，也能实现专业、可维护、可集成的 API 测试体系。

一、为何选择 `curl + jq`？

工具	作用说明	优势
`curl`	命令行 HTTP 客户端，支持 GET/POST/PUT 等请求方法	原生命令，跨平台、调试直观
`jq`	命令行 JSON 处理器，可提取、筛选、重组数据结构	功能强大，语法直观，输出友好

它们共同构成了一个轻量、灵活的接口测试微框架，尤其适合快速验证、自动化脚本嵌套、数据驱动测试等场景。

二、接口测试基本流程回顾

任何一次接口验证，通常都包括以下几个步骤：

构造请求（Request）
获取响应（Response）
解析返回数据
断言校验预期结果
输出验证报告或日志

我们将以此为核心，构建起命令行接口测试逻辑。

三、`curl` 命令详解：构造请求

1. GET 请求基本格式

curl -s https://api.example.com/user/123

-s：silent 模式，防止冗余进度输出。

2. POST 请求示例

curl -s -X POST https://api.example.com/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin", "password":"123456"}'

3. 设置 Header 和 Token

curl -s -H "Authorization: Bearer $TOKEN" https://api.example.com/user

四、使用 `jq` 提取响应字段

设响应为以下 JSON：

{
  "code": 200,
  "data": {
    "id": 123,
    "username": "admin",
    "status": "active"
  }
}

我们可以用 jq 提取并断言：

curl -s https://api.example.com/user/123 | jq '.data.status'

输出结果：

"active"

如果我们想将值赋予变量：

status=$(curl -s https://api.example.com/user/123 | jq -r '.data.status')

加 -r 可去除引号，便于后续处理。

五、构建自动断言逻辑

结合 shell 条件判断，即可实现自动验证：

expected="active"
actual=$(curl -s https://api.example.com/user/123 | jq -r '.data.status')

if [[ "$actual" == "$expected" ]]; then
  echo "✅ 接口状态验证成功"
else
  echo "❌ 验证失败，期望 $expected，实际 $actual"
  exit 1
fi

支持条件可嵌套组合：

response=$(curl -s https://api.example.com/user/123)

code=$(echo "$response" | jq -r '.code')
id=$(echo "$response" | jq -r '.data.id')

if [[ "$code" -eq 200 && "$id" -gt 0 ]]; then
  echo "✅ 响应结构合法"
else
  echo "❌ 响应异常"
fi

六、接口自动验证脚本模板

#!/bin/bash

API="https://api.example.com/user/123"
EXPECTED_STATUS="active"

echo "📡 请求接口：$API"
RESPONSE=$(curl -s "$API")

STATUS=$(echo "$RESPONSE" | jq -r '.data.status')
USERNAME=$(echo "$RESPONSE" | jq -r '.data.username')

echo "👤 用户名：$USERNAME"
echo "📍 状态字段：$STATUS"

if [[ "$STATUS" == "$EXPECTED_STATUS" ]]; then
  echo "✅ 状态校验通过"
else
  echo "❌ 状态校验失败：期望 $EXPECTED_STATUS，实际 $STATUS"
  exit 1
fi

可用于本地测试，也可嵌入 CI/CD 流水线中：

# 示例 GitLab CI 任务片段
test_api:
  script:
    - chmod +x ./validate_api.sh
    - ./validate_api.sh

七、数据驱动与多接口批量验证

1. 使用循环批量验证多个接口

declare -A urls=(
  ["用户接口"]="https://api.example.com/user/1"
  ["订单接口"]="https://api.example.com/order/1"
)

for name in "${!urls[@]}"; do
  echo "🔍 验证 $name"
  code=$(curl -s "${urls[$name]}" | jq -r '.code')
  if [[ "$code" -eq 200 ]]; then
    echo "✅ $name 正常"
  else
    echo "❌ $name 返回码异常"
  fi
done

2. 动态提取 Token 并注入下游接口

TOKEN=$(curl -s -X POST https://api.example.com/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin", "password":"123456"}' | jq -r '.token')

curl -s -H "Authorization: Bearer $TOKEN" https://api.example.com/user

八、优势对比与应用场景

对比项	`curl + jq` 方式	Postman / 传统工具
部署依赖	仅需命令行环境	需 GUI 或脚本插件
自动化集成	高（shell/native）	中（需转换或插件）
性能与速度	极快（秒级）	相对较慢
脚本复用性	高（支持模板化、通配符）	中（复制配置繁琐）
用户体验	稍有门槛（需熟悉语法）	可视化界面，易上手