把静态站放到 Cloudflare 上遇到的几个小坑

☁️ 先说好的部分#

连上 GitHub 仓库之后，推一次代码就自动构建，两分钟左右上线，免费额度对个人博客完全够用。CDN 也快，国内访问虽然不算飞快但能用。

下面说坑。

🕐 坑一：改完配置线上没变#

有次改了配置推上去，刷新页面还是旧的。

原因是浏览器和 CDN 双重缓存。验证的时候要在 URL 后面加个随机参数，比如 ?v=12345，否则你拿到的可能是几分钟前的版本。

改了 favicon 尤其明显——浏览器会死死记住旧图标，得强制刷新（Ctrl+Shift+R）才换得过来。

🌏 坑二：时区#

构建机器的时区是 UTC。如果你的文章按”日期”过滤，或者首页要显示”今天”，可能会差 8 个小时。

涉及日期的判断，最好显式指定 Asia/Shanghai，别依赖运行环境。

🔗 坑三：微信里打不开#

这个不是 Cloudflare 的问题，但会一起遇到：新域名在微信里容易被拦截，提示”已停止访问”。

跟域名后缀（便宜后缀信誉分低）和有没有备案关系很大。解决办法是去腾讯网址安全中心申诉，一般几个工作日。

🛠 坑四：构建失败看不懂#

构建日志里报错往往很抽象。最常见的两类：

1. Markdown 的 frontmatter 格式错了——缩进、引号、冒号后没空格都会挂
2. 引用了不存在的资源——改了图片路径但文件没传上去

改之前先在脑子里过一遍”这个文件引用的东西都还在吗”，能省很多时间。