开发文档
从浏览器和命令行检查 Web 项目是否发布成功。
HTTPS 上线检查
- 核对 DNS。 查询 A 记录,并检查是否有指向旧地址的 AAAA 记录。如果站点只配置了 IPv4,不要保留失效的 AAAA 记录。
- 检查 HTTP 与 HTTPS。 HTTP 应跳转到预期域名,HTTPS 不应出现证书警告。用
curl -I看首个响应,再用curl -IL检查完整跳转链。 - 检查资源请求。 打开浏览器的网络面板重新加载页面,确认 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。