隐藏的博客文章还在首页显示？排查 Astro draft 机制问题

第一层：draft 过滤逻辑#

查看 src/utils/content-utils.ts 中获取文章列表的函数：

1
const allBlogPosts = await getCollection("posts", ({ data }) => {
2
    return import.meta.env.PROD ? data.draft !== true : true;
3
});

问题出在这里。import.meta.env.PROD 在本地开发环境（pnpm dev）下是 false，此时过滤函数恒返回 true——所有文章包括草稿全部显示。所以本地预览时永远看到全部文章，分类计数也是错的。

修复很简单：去掉环境判断，始终过滤草稿。

1
return data.draft !== true;

第二层：为什么部署到服务器后还不对？#

代码改完、部署成功后，用户说还是看到旧内容。这就不是 draft 逻辑的问题了——应该是浏览器缓存。

检查服务器返回的响应头：

1
Cache-Control: no-cache

no-cache 的语义是”可以缓存，但使用前必须向服务器验证”。大部分浏览器会遵守这个规则，但 Safari 等浏览器的 bfcache（后退缓存） 在回退导航时会直接使用页面快照，根本不发验证请求。

将 HTML 的缓存策略改为更严格的 no-store：

1
# 旧
2
location ~* \.html$ {
3
    expires -1;
4
    add_header Cache-Control "no-cache";
5
}
6

7
# 新
8
location ~* \.html$ {
9
    add_header Cache-Control "no-store, must-revalidate";
10
}

no-store 告诉浏览器完全不要缓存页面，每次导航都从服务器获取最新内容。

第三层：配置怎么每次部署都丢了？#

配置写好后，部署一次博客——配置又丢了，容器退回到默认 nginx 配置。

查 deploy-server.yml 的 SCP 步骤：

1
- uses: appleboy/scp-action@v0.1.7
2
  with:
3
    source: "dist/"
4
    target: "/path/to/blog"
5
    rm: true

rm: true 每次部署清空整个目标目录再上传。而我把 nginx 配置放在了 /path/to/blog/conf/ 下——正好被清掉。

修复：把 nginx 配置文件移出 SCP 的打击范围。

1
/path/
2
├── blog/          # SCP 目标（rm:true 清空这里）
3
│   └── dist/      # 博客静态文件
4
└── nginx/
5
    └── conf/
6
        └── default.conf   # nginx 配置（SCP 碰不到）