CI/CD / 系统课时
执行冒烟测试
执行冒烟测试
冒烟测试要在新版本发布后,用很少的用例快速证明服务已经启动、关键依赖可用、核心业务能够走通。它不是完整回归测试,而是部署后的第一道自动门禁:核心路径一旦失败,就立即阻止继续放量或进入全量发布。
学习目标
- 能挑出适合发布后立即执行的最小冒烟用例集合。
- 能用脚本检查状态码、关键响应内容和核心业务路径。
- 能把冒烟测试接入发布流程,并正确处理暂未就绪与真实故障。
只测试最关键的发布风险
冒烟测试应尽量短,通常覆盖三层:进程与健康状态、关键依赖连通性、一个最核心的业务闭环。不要把几十分钟的完整回归套件塞进冒烟阶段,否则发布门禁会变慢,失败原因也更难快速定位。
以订单 API 为例,可以约定三个检查:/healthz 返回健康状态;/api/version 能确认当前实例已加载应用版本;/api/orders/quote 能完成一次无副作用的报价请求。若业务没有安全的只读关键路径,应准备专用测试租户或能够自动清理的数据。
编写能够阻断流水线的脚本
下面脚本只依赖 Bash、curl 和 grep。它同时检查 HTTP 状态码和关键响应内容;任何一步失败都会以非 0 状态结束,CI/CD 系统可以据此停止后续发布阶段。
#!/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"假设被测服务满足以上接口契约,可以在发布环境执行脚本:
BASE_URL="https://app.example.com" bash smoke.sh预期输出:
PASS health
PASS version
PASS order-quote
SMOKE TEST PASSED如果任一接口返回非预期状态码,或者响应中缺少约定内容,脚本会输出 FAIL 并以非 0 状态结束。真实项目应把示例路径、请求体和断言替换为本服务稳定且明确的接口契约。
把冒烟失败变成发布门禁
冒烟测试应位于“新实例已经就绪”之后、“继续扩大流量”之前。流水线先完成部署并等待就绪探针通过,再运行 smoke.sh;脚本成功才进入下一发布阶段,失败则冻结发布并执行自动回退或人工处置。
需要区分两类失败:服务确实发生故障,以及服务仍处于短暂启动阶段。后者可以在测试开始前进行有限次数的就绪重试,例如每 5 秒检查一次、最长等待 60 秒;达到上限仍未就绪,就必须按发布失败处理。无限重试只会把明显故障隐藏起来。
让失败结果能够直接定位
冒烟脚本不能只返回一个红色状态。至少应输出失败检查名称、HTTP 状态码以及必要的响应摘要,使值班人员能快速判断是健康检查、版本路由还是核心业务接口出了问题。同时要避免把访问令牌、用户隐私或完整敏感响应写入流水线日志。
发布系统还应记录部署版本、目标环境、测试时间和失败步骤。这样当灰度或全量门禁触发时,可以直接关联到对应版本和日志,而不是重新确认“测试究竟打到了哪个版本”。
控制冒烟测试的边界
适合冒烟测试的是数量少、稳定、失败后必须阻断发布的用例;复杂业务边界、长时间数据处理、全量兼容性验证和大量异常分支,应放到部署前自动化测试或部署后的完整回归阶段。
可靠的发布链路应先等待新实例就绪,再自动执行冒烟测试,通过后才继续灰度或全量发布。这样配置错误、依赖不可达、路由失效和核心接口故障都能在影响范围仍然很小时被发现。