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 中的状态、上游与耗时;不要只在终端成功一次就停止监控。比较发布前后的错误率和延迟,确认所有实例已切换,缓存中的旧版本也有预期处理。

记录通过与未通过的项目,保留请求和响应证据。任何关键路径异常都应触发事先约定的回退条件;“命令执行过”和“用户请求符合预期”应分别记录。

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

目录与阅读设置

阅读设置

17

记录一个想法

发布后应该验证哪些内容

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

登录哪都通