CI/CD / 系统课时

执行冒烟测试

执行冒烟测试

冒烟测试要在新版本发布后,用很少的用例快速证明服务已经启动、关键依赖可用、核心业务能够走通。它不是完整回归测试,而是部署后的第一道自动门禁:核心路径一旦失败,就立即阻止继续放量或进入全量发布。

学习目标

  • 能挑出适合发布后立即执行的最小冒烟用例集合。
  • 能用脚本检查状态码、关键响应内容和核心业务路径。
  • 能把冒烟测试接入发布流程,并正确处理暂未就绪与真实故障。

只测试最关键的发布风险

冒烟测试应尽量短,通常覆盖三层:进程与健康状态、关键依赖连通性、一个最核心的业务闭环。不要把几十分钟的完整回归套件塞进冒烟阶段,否则发布门禁会变慢,失败原因也更难快速定位。

以订单 API 为例,可以约定三个检查:/healthz 返回健康状态;/api/version 能确认当前实例已加载应用版本;/api/orders/quote 能完成一次无副作用的报价请求。若业务没有安全的只读关键路径,应准备专用测试租户或能够自动清理的数据。

编写能够阻断流水线的脚本

下面脚本只依赖 Bash、curl 和 grep。它同时检查 HTTP 状态码和关键响应内容;任何一步失败都会以非 0 状态结束,CI/CD 系统可以据此停止后续发布阶段。

bash
#!/usr/bin/env bash
set -euo pipefail

BASE_URL="${BASE_URL:-http://127.0.0.1:8080}"
BODY="$(mktemp)"
trap 'rm -f "$BODY"' EXIT

check() {
  local name="$1"
  local method="$2"
  local path="$3"
  local expected_code="$4"
  local expected_text="$5"
  local data="${6:-}"

  if [[ -n "$data" ]]; then
    code="$(curl -sS -o "$BODY" -w '%{http_code}' -X "$method" -H 'Content-Type: application/json' --data "$data" "$BASE_URL$path")"
  else
    code="$(curl -sS -o "$BODY" -w '%{http_code}' -X "$method" "$BASE_URL$path")"
  fi

  if [[ "$code" != "$expected_code" ]] || ! grep -Fq "$expected_text" "$BODY"; then
    echo "FAIL $name: code=$code body=$(cat "$BODY")"
    return 1
  fi

  echo "PASS $name"
}

check "health" GET "/healthz" 200 '"status":"ok"'
check "version" GET "/api/version" 200 '"version"'
check "order-quote" POST "/api/orders/quote" 200 '"currency":"USD"' '{"sku":"smoke-sku","quantity":1}'

echo "SMOKE TEST PASSED"

假设被测服务满足以上接口契约,可以在发布环境执行脚本:

bash
BASE_URL="https://app.example.com" bash smoke.sh

预期输出:

text
PASS health
PASS version
PASS order-quote
SMOKE TEST PASSED

如果任一接口返回非预期状态码,或者响应中缺少约定内容,脚本会输出 FAIL 并以非 0 状态结束。真实项目应把示例路径、请求体和断言替换为本服务稳定且明确的接口契约。

把冒烟失败变成发布门禁

冒烟测试应位于“新实例已经就绪”之后、“继续扩大流量”之前。流水线先完成部署并等待就绪探针通过,再运行 smoke.sh;脚本成功才进入下一发布阶段,失败则冻结发布并执行自动回退或人工处置。

需要区分两类失败:服务确实发生故障,以及服务仍处于短暂启动阶段。后者可以在测试开始前进行有限次数的就绪重试,例如每 5 秒检查一次、最长等待 60 秒;达到上限仍未就绪,就必须按发布失败处理。无限重试只会把明显故障隐藏起来。

让失败结果能够直接定位

冒烟脚本不能只返回一个红色状态。至少应输出失败检查名称、HTTP 状态码以及必要的响应摘要,使值班人员能快速判断是健康检查、版本路由还是核心业务接口出了问题。同时要避免把访问令牌、用户隐私或完整敏感响应写入流水线日志。

发布系统还应记录部署版本、目标环境、测试时间和失败步骤。这样当灰度或全量门禁触发时,可以直接关联到对应版本和日志,而不是重新确认“测试究竟打到了哪个版本”。

控制冒烟测试的边界

适合冒烟测试的是数量少、稳定、失败后必须阻断发布的用例;复杂业务边界、长时间数据处理、全量兼容性验证和大量异常分支,应放到部署前自动化测试或部署后的完整回归阶段。

可靠的发布链路应先等待新实例就绪,再自动执行冒烟测试,通过后才继续灰度或全量发布。这样配置错误、依赖不可达、路由失效和核心接口故障都能在影响范围仍然很小时被发现。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

执行冒烟测试

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通