ECUT Dev Lab

开发文档

从浏览器和命令行检查 Web 项目是否发布成功。

HTTPS 上线检查

  1. 核对 DNS。 查询 A 记录,并检查是否有指向旧地址的 AAAA 记录。如果站点只配置了 IPv4,不要保留失效的 AAAA 记录。
  2. 检查 HTTP 与 HTTPS。 HTTP 应跳转到预期域名,HTTPS 不应出现证书警告。用 curl -I 看首个响应,再用 curl -IL 检查完整跳转链。
  3. 检查资源请求。 打开浏览器的网络面板重新加载页面,确认 CSS、脚本和图片已加载。若脚本请求返回了 HTML,优先核对静态文件路径。
curl -I http://dev.ecut-gamer.online/
curl -I https://dev.ecut-gamer.online/docs/
curl -fsS https://dev.ecut-gamer.online/health

本站的 /health 只验证公开 Web 服务是否响应,不检查其他系统。

读懂浏览器的请求耗时

在浏览器开发者工具的 Network 面板选择文档请求并查看 Timing。

DNS / Connect / SSL
建立新连接前后的开销。如果复用了连接,部分阶段不会出现。
Waiting (TTFB)
从发出请求到接收首字节的耗时,包含网络延迟和服务端处理,不等同于服务端处理时长。
Content Download
从首字节到响应结束。若只在大文件上变长,可对比不同网络下的下载速率。

用连接诊断对比小请求耗时和 4 MiB 文件下载。结果只代表到本站的连接,不能当作宽带的标称速度。

静态资源缓存排查

发布后仍显示旧样式时,先在 Network 中观察资源是否来自内存、磁盘缓存或 Service Worker。临时禁用浏览器缓存后再重试,不必先清空所有站点数据。

可以为 CSS 和 JavaScript 文件名加内容哈希,并让 HTML 引用新文件名。带哈希的资源可以用较长的缓存期限;HTML 应更频繁地重新验证。部署时先上传新资源,再发布引用它们的 HTML。