Cache-Control、ETag 与 304：静态博客缓存的取舍
缓存可以减少传输和重复请求，但设置得过长也会让更新迟迟不生效。静态博客适合把 HTML 与带版本的资源分开设计。
HTML 与资源不必采用同一策略
HTML 决定页面引用哪些资源，通常需要较短的新鲜期或允许重新验证。带内容哈希的资源文件可以采用较长缓存；如果文件名不变而内容改变，长期 immutable 很容易让读者一直使用旧版本。
304 不是失败
客户端携带 If-None-Match 或 If-Modified-Since 重新验证时，服务端可以返回 304，表示继续使用已有副本。这个请求仍然发生了，只是省去响应正文。检查工具看到 304 时，要结合缓存与请求头理解。
浏览器缓存与 CDN 缓存分别管理
Cache-Control 中的指令可能对浏览器、共享缓存产生不同影响。CDN 还可能设置额外规则。排查时应查看 Age、Vary 和相关缓存状态，不要把本机强刷等同于所有用户缓存被清空。
小步调整并保留验证路径
先对 CSS、JavaScript 和图片设置适度缓存，再验证更新行为。确保不存在或已移除的资源返回正确的 404，而不是缓存一份错误页面。部署后抽查响应头，并在真实页面中确认样式和脚本版本一致。
操作参考
1 | curl -I https://example.com/css/site.css |
示例中的域名、文件名和地址需按实际环境替换。涉及生产配置时，先保留可恢复副本，再做修改。
参考资料
本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 SkynetX！
相关推荐
2026-11-02
提交 sitemap 后，为什么搜索引擎还没有收录
提交、抓取、索引和排名是四个不同阶段。提交 sitemap 只是提供地址清单，搜索引擎仍会决定什么时候抓取、是否建立索引以及怎样展示。 先确认抓取入口正常页面应返回合适状态码，robots.txt 不应误拦正文，且不能意外设置 noindex。登录后才能看到的内容、持续返回错误的页面或跳转循环，都可能阻断后续处理。 让重复路径收敛到主地址裸域名、www、index.html 和旧文章路径不应各自展示同一正文。使用合适的重定向与 canonical，并让站点地图列出最终 URL。canonical 是提示，不是搜索引擎必须执行的命令。 内容要能独立回答问题文章只有标题、几段套话和重复插图，很难提供独特价值。明确适用条件、真实操作步骤、结果解释和参考资料，比不断增加页面数量更有意义。历史时间也不应伪装成有证据的首发记录。 用站长工具观察，而不是反复提交Google Search Console 和 Bing Webmaster Tools 可以提供验证与索引状态，但需要对应账号完成所有权验证。IndexNow 通知的是参与该协议的引擎，不能当作 Google 收录提交。即使接口接...
2026-11-02
实战：Nginx 返回 502，如何一步步检查上游
502 表示网关没有得到期望的上游响应。它不等于域名解析一定错误，也不等于网站数据库损坏。先沿请求路径逐段测试，往往能快速确定范围。 找到实际生效的配置先确认是宿主机 Nginx、OpenResty 容器还是其他代理。读取生效配置中的 proxy_pass、location 和请求头，避免编辑了一份没有被加载的文件。完整配置可能含敏感信息，不要原样公开。 从代理环境请求上游在代理所在网络空间内请求 upstream。宿主机的 127.0.0.1 与桥接容器里的地址不同；服务名则依赖 Docker 网络与 DNS。测试时保留正确 Host 与协议，因为一些应用会做来源校验。 把错误日志与现象对应起来connection refused 常提示监听或地址问题；upstream timed out 要检查连接与响应阶段；prematurely closed connection 需要结合应用崩溃与协议设置。不要把所有错误都用增大 timeout 解决。 最小改动并验证完整路径先校验配置，通过后重载。分别测试上游、HTTPS 域名、文章和接口。WebSocket 与流式响应需要单独检...
2026-11-02
一份可复用的网站发布与回退记录模板
发布记录不必很长，但需要覆盖目标、变更、检查与回退条件。下面这份模板适合个人静态网站，也可以作为更复杂系统的起点。 发布前写清目标与范围记录涉及的页面、脚本、资源和服务器配置。列出构建环境与依赖版本，并确认备份的位置和可读性。发布任务与数据迁移不同，后者需要额外的一致性计划。 定义可验证的成功标准至少检查主域名、www 跳转、代表性文章、工具交互和下载完整性。涉及视频时测试 Range 请求；涉及 SEO 时检查 canonical 和 sitemap。标准应针对实际功能，而不是固定复制清单。 明确什么时候回退例如关键页面持续失败、工具功能回归或证书异常。回退需要同时考虑源码、产物和 Web 配置。不要只恢复某个 HTML 文件，却保留不相容的新脚本。 发布后记录真实结果把成功、失败与未执行的检查分开。模拟手机视口不等于真机验收，接口接受提交不等于搜索引擎收录。保留这些边界能让下一次维护更可靠。 操作参考12345678发布版本：变更范围：备份位置：构建结果：入口与页面检查：移动端检查方式：回退触发条件：已知限制与后续事项： 示例占位符需替换为自己的环境。涉及生产服务时先保...
2026-11-02
手机网页验收：除了“能打开”，还应该看什么
桌面浏览器缩窄窗口可以发现布局问题，却不能完全替代手机测试。触摸、软键盘、浏览器工具栏和真实网络，都可能改变页面行为。 先看内容能不能舒适阅读检查正文是否必须放大、段落行距是否足够、标题是否被固定导航遮住。代码块可以内部滚动，但不应撑宽整个页面。图片需要保持比例，加载前最好预留空间，减少阅读时突然跳动。 测试菜单和输入框用手指打开导航，确认弹层能关闭、页面能继续滚动。点入文本框后观察键盘是否遮住按钮。输入框字体过小可能触发部分浏览器自动缩放，造成布局和操作体验变化。 选择有代表性的页面首页、长文章、分类列表和工具箱各测一个。下载需要确认触发的是文件，而不是把错误页面保存成 ZIP。长中文标题、英文 URL 和多列数据，都是容易暴露溢出问题的内容。 区分模拟测试与真机结果移动视口可检查断点，设备模拟可补充像素比和触摸行为，但仍不是物理设备。验收记录应写明机型、系统、浏览器和网络条件；没有实际测试的项目应明确保留，不写成全部通过。 操作参考12345建议记录：视口或机型：系统与浏览器：菜单、输入、滚动、下载：横向溢出与布局跳动： 示例中的域名、文件名和地址需按实际环境替换。涉及...
2025-11-04
静态博客的日常写作流程，可以有多简单
日期说明：归档日期为历史整理日期，不代表原始首发时间；本文于 2026-11-02 核对并修订。命令示例需按实际环境替换占位符。 文章保存在 Markdown，主题配置决定展示方式，生成目录负责对外提供页面。本文整理两个容易忽略的环节，作为日常使用时的检查参考。 内容和生成结果分开文章保存在 Markdown，主题配置决定展示方式，生成目录负责对外提供页面。把三者分开，修改主题时就不容易误伤原稿，也更方便迁移到其他框架。 发布前做一个小检查检查标题、链接、封面、摘要与移动端阅读。图片采用本地文件时，应确认它们进入构建产物。日期变化可能改变固定链接，已公开的旧链接需要考虑重定向。 日常使用的小结保留源文件备份比只保留 HTML 更重要。日常写作不需要复杂流水线，但发布过程最好能重复执行，并能恢复到上一个版本。 操作参考与适用边界构建前检查变化12git diff -- source _config.ymlnpx hexo generate 构建成功后应检查产物目录与资源链接。generate 可能保留旧文件，clean 会清理生成结果；发布前需要选择明确的同步策略，而不是...
2026-11-02
静态网站发布前的十分钟检查清单
发布成功，不等于读者已经能正常使用。页面内容、浏览器行为与服务器配置需要各自验证。下面是一套适合个人博客的小规模发布流程。 先检查构建结果在源目录执行构建，确认没有模板错误。打开产物目录，检查首页、文章页、分类页和下载文件是否都存在。首页正常而文章缺失，可能是草稿状态、日期设置或目录路径问题。保留构建日志，避免只看最后一行成功提示。 核对链接与静态资源选择一篇旧文章、一篇新文章、一个分类和一个下载入口。检查图片、样式与脚本的请求路径，尤其注意部署到子目录后的绝对路径。资源版本号应随内容变化更新，否则缓存可能继续展示旧文件。 验证入口与 HTTPS分别测试裸域名和 www；应统一跳转到约定的主域名，并保留页面路径。证书要覆盖两个域名，不能先发生证书错误再指望 HTTP 重定向补救。使用 curl -I 查看状态与 Location，再做一次跟随跳转的 GET 请求。 最后检查手机与可回退性窄屏重点检查导航、长表格、代码块与表单。发布前记录源代码版本、配置与数据备份位置。回退演练可以只读取备份中的关键文件，不需要真的覆盖生产站。每次发布保留一份简短记录：做了什么、验证了什么、哪些...
