1、检查文章文件是否写到正确目录#

现在新博客文章都放在：

1
/www/wwwroot/blog_app/blog_web_app/src/content/posts

如果是每天新增的文章，可以统一放在：

1
src/content/posts/daily/年份-月份-日期/

例如今天的文章目录：

1
src/content/posts/daily/2026-06-29/

这样做的好处是：

1. 后面找当天写过什么文章比较方便。
2. 不会和迁移过来的旧文章混在一起。
3. 自动化任务也更容易判断今天是否已经写过。

2、检查 frontmatter 是否完整#

每篇文章开头都需要有这些字段：

1
---
2
title: "文章标题"
3
published: 2026-06-29
4
description: "文章摘要"
5
image: "api"
6
tags: ["博客标签"]
7
category: "博客相关分类"
8
draft: false
9
comment: true
10
---

其中最重要的是：

• title：文章标题。
• published：发布时间，不要乱改旧文章的发布时间。
• category：必须和已有分类一致。
• draft: false：表示公开发布。

如果 draft 写成 true，文章就不会出现在前台。

3、检查构建是否成功#

文章写完以后，进入项目目录执行：

1
cd /www/wwwroot/blog_app/blog_web_app
2
NODE_OPTIONS=--max-old-space-size=1536 pnpm build

如果构建成功，会看到类似：

1
[build] Complete!

如果构建失败，通常先检查这几类问题：

1. frontmatter 的冒号、引号、数组格式是不是写错。
2. Markdown 代码块是不是少了结尾的三个反引号。
3. 图片地址是不是空字符串以外的非法值。
4. MDX 文件里是否写了不合法的 JSX。

4、检查公开文章数量#

构建后可以看这个文件：

1
dist/api/allPostMeta.json

里面会列出当前公开文章。如果新增文章没有出现在这里，说明可能是：

• draft 还是 true。
• 分类或日期格式错误导致内容集合校验失败。
• 文件没有放到 src/content/posts 下面。

5、检查线上页面是否能访问#

构建成功后，需要抽查新文章页面是否返回 200：

1
curl -k -I https://blog.tjcheng.cn/posts/daily/2026-06-29/blog-maintenance-checklist/

如果返回 200 OK，说明页面已经生成并且 Nginx 可以访问。

总结#

博客后续要长期写下去，最重要的是形成固定流程：

1
写文章 -> 检查 frontmatter -> 构建 -> 检查文章元数据 -> 抽查线上页面

只要每天都按这个流程走，后面文章数量变多也不会乱。