DevOps 实践 从静态资源缺失到发布恢复
用可下载的本地样例复现 HTML 200 与脚本 404,按文件清单和请求定位问题,再回滚旧版、验证修复与发布前检查。

页面能打开,按钮却没有反应时,先检查入口 HTML 引用的关键资源,再看浏览器有没有完成预期动作。这篇 DevOps 实践用一个本地静态站样例走完故障定位、回滚和修复:故意遗漏 assets/app.js 后,HTML 仍返回 200,脚本返回 404;切回完整旧版后,页面恢复,再用完整新包重新验证。
样例只用 Python 标准库,在临时目录启动本地 HTTP 服务,全部数据为合成内容。它模拟发布包遗漏文件,便于练习检查顺序;下文的响应和浏览器状态来自这次实际运行。
先把失败做成可重跑的输入
下载复现样例,解压后运行:
unzip static-release-fixture.zip -d static-release-fixture
cd static-release-fixture
python3 reproduce.py results
脚本会创建三个发布目录:v1 是完整旧版,v2-broken 只有 HTML,v2-fixed 是包含脚本的完整新版。三个版本通过一个 current 符号链接交给同一个服务器读取。每次切换后,它请求首页与脚本,断言响应并保存 results/results.json;退出时关闭线程和服务。输出目录还保留三个版本的副本,方便手动检查。
这次在 Darwin arm64、Python 3.9.6 上运行得到:
Failure v2-broken HTML 200 JS 404
Rollback v1 HTML 200 JS 200
Repair v2-fixed HTML 200 JS 200
从用户症状缩小到缺失文件
先用 find 看实际发布包,再看 HTML 的脚本地址,最后请求同一个地址:
find results/v2-broken -type f
grep 'script src' results/v2-broken/index.html
python3 -m http.server 8000 --bind 127.0.0.1 \
--directory results/v2-broken
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8000/
curl -s -o /dev/null -w '%{http_code}\n' \
http://127.0.0.1:8000/assets/app.js
第一条命令只列出 index.html;HTML 中却有 src="/assets/app.js"。两个 curl 输出依次是 200 与 404。文件清单验证“包里有没有这个资源”,HTTP 请求验证“当前服务器能不能按页面使用的路径取到它”。两者指向同一个缺失文件,排查已足够收窄。
MDN 对 404 的说明是服务器找不到请求资源。单独一个 404 不能确定是文件未打包、路径错误还是服务配置问题;这里结合发布目录,才能确认本样例是文件遗漏。首页 200 只证明 HTML 能被取到,尚未证明 JavaScript 执行成功。
手动打开上述服务器的首页,会看到 Loading v2...。这是 HTML 的初始状态;脚本本应把它改成 Ready v2。浏览器里的状态给 HTTP 检查补了一项功能证据。
先恢复旧版 再验证修复包
自动脚本用临时链接指向候选版本,再以 os.replace 替换 current,避免先删除链接造成空档。在本样例中,切回 v1 后脚本恢复为 200,浏览器显示 Ready v1;完整的 v2-fixed 则得到 Ready v2。
手动浏览器复查时,先停止自己的 8000 端口服务,把 --directory 依次换为 results/v1 和 results/v2-fixed,每次都访问根地址 http://127.0.0.1:8000/。HTML 引用的是绝对 /assets/app.js,所以服务器的根目录必须对应所检查的版本。切换同一 URL 的版本时,临时禁用浏览器缓存再刷新,可避免相同文件名的缓存影响观察。

本地样例报告。上半部分是实际 HTTP 响应,下方记录根目录对应正确版本后的浏览器状态。
| 阶段 | 首页 | 脚本 | 浏览器显示 |
|---|---|---|---|
| 遗漏脚本的新版 | 200 | 404 | Loading v2… |
| 回滚完整旧版 | 200 | 200 | Ready v1 |
| 验证完整新版 | 200 | 200 | Ready v2 |
回滚成立的前提是旧包仍可用、切换对象明确。本样例只有静态文件;带数据库迁移、后台任务或共享写入状态的应用,还需要检查旧代码与当前数据是否兼容。这里的链接替换也只代表单机文件系统上的切换方式,不能直接替代 CDN 或多节点发布流程。
把这次缺失变成发布前检查
文件遗漏已经定位,就可以把“必须存在的文件”变成候选包检查:
required = ['index.html', 'assets/app.js']
complete = all((candidate / path).is_file() for path in required)
assert complete
这次检查拒绝 v2-broken,接受 v2-fixed。两项文件清单适合这个最小样例;真实构建常有带 hash 的文件名,应从当前 HTML 或构建 manifest 导出资源清单,并检查引用资源的存在、响应内容类型以及一次关键交互。只增加首页探针,会继续漏掉同一种故障。
修复后需要保留的证据很小:实际发布包、检查命令、对应结果和已知可回退版本。它们让下一次故障能从一个具体假设开始,也让恢复是否成功有可核对的条件。
继续复现与阅读
Python http.server 文档说明了目录服务行为,也明确它不建议用于生产。本样例用它缩小变量;线上应在实际部署方式下重复资源与交互检查。
更多可复用步骤见工作流与方法。