Web 服务器与网关 / 系统课时
发布后应该验证哪些内容
发布后应该验证哪些内容
重载成功只说明发布过程向前走了一步,用户可能仍访问到旧入口、错误页面或错误的 API 路径。本篇用一组状态与正文同时检查的冒烟请求建立验收习惯,再把域名、HTTPS、日志和实例范围加入发布记录。
学习目标
- 为静态页面、资源、API 与错误路径定义明确期望。
- 自动核对状态和正文,避免把错误页的 200 当作成功。
- 沿用户实际入口验证证书、实例版本和日志。
先写出关键请求矩阵
至少包含首页、一个带哈希的资源、一个只读 API、一个不存在资源以及需要保护的路径。请求方法、Host、参数和认证状态必须与实际业务一致;不要在生产冒烟中反复触发扣款或发送消息等副作用。
| 请求类别 | 不能只看什么 |
|---|---|
| 首页或 SPA 路由 | 200 还要对应正确版本 |
| 静态脚本 | 200 还要类型正确且不是 HTML 回退 |
| API | 状态、结构和业务结果都正确 |
| 错误与受控路径 | 应拒绝的请求仍然被拒绝 |
建立可重复的本机矩阵
实验需要 Python 3、Nginx 1.28 和空闲回环 8080。先运行完整准备程序:
python
from pathlib import Path
p = Path('/tmp/nginx-smoke-lab/assets')
p.mkdir(parents=True, exist_ok=True)
(p / 'app.abc123.js').write_text('console.log("v1");\n')预期结果:创建指定脚本,无输出。以下片段示例放在 http;API 用固定响应模拟,只用于验收程序练习:
nginx
server {
listen 127.0.0.1:8080;
server_name smoke.test;
root /tmp/nginx-smoke-lab;
types { application/javascript js; }
location = / { return 200 "web-v1\n"; }
location = /api/health { return 200 "api-ok\n"; }
location /assets/ { try_files $uri =404; }
location / { return 404; }
}检查并重载后,运行完整 Python 程序:
python
import http.client
cases = [
('/', 200, 'web-v1\n'),
('/api/health', 200, 'api-ok\n'),
('/assets/app.abc123.js', 200, 'console.log("v1");\n'),
('/assets/missing.js', 404, None),
]
for path, expected_status, expected_body in cases:
conn = http.client.HTTPConnection('127.0.0.1', 8080, timeout=3)
try:
conn.request('GET', path, headers={'Host': 'smoke.test'})
res = conn.getresponse()
data = res.read().decode()
assert res.status == expected_status, (path, res.status)
if expected_body is not None:
assert data == expected_body, (path, data)
if path.endswith('abc123.js'):
assert res.getheader('Content-Type') == 'application/javascript'
print(path, res.status)
finally:
conn.close()预期输出:
text
/ 200
/api/health 200
/assets/app.abc123.js 200
/assets/missing.js 404验证用户实际经过的链路
公网验收还要检查 DNS 的各个地址、IPv4/IPv6、负载均衡、CDN 和每台发布实例。可用 curl --resolve 对指定入口验证域名,同时保留正常 TLS 信任与名称检查;不能用 -k 把错误证书变成通过。
确认 HTTP 到 HTTPS 的目标、路径、查询参数与跳转次数,检查真实证书链和有效期。上面的纯 HTTP 本机实验没有覆盖这些项目,必须在对应环境独立验收。
日志与持续观察一起收尾
将测试时间、请求标识与发布版本关联,查看 access/error log 中的状态、上游与耗时;不要只在终端成功一次就停止监控。比较发布前后的错误率和延迟,确认所有实例已切换,缓存中的旧版本也有预期处理。
记录通过与未通过的项目,保留请求和响应证据。任何关键路径异常都应触发事先约定的回退条件;“命令执行过”和“用户请求符合预期”应分别记录。
按自己的节奏,确认真正理解。