Nuxt 3 博客 sitemap 总漏新文章:我用增量生成、lastmod 校准和主动推送修好收录
sitemap 不是构建产物就完事。我把 Nuxt 3 博客的 sitemap 改成动态增量输出,校准 lastmod,再配合发布后推送,新文章收录才稳定闭环。

作者
ZHOUYI
之前博客发完文章,我总以为 sitemap.xml 会自己跟上。结果后台一看,新文经常不在 sitemap 里,搜索引擎抓取也慢半拍。最初我怀疑 Nuxt 3 路由没生成,后来才发现根因很简单:sitemap 被我当成构建时静态文件了。文章是发布后写入 MongoDB 的,sitemap 却还停留在上一次构建或旧缓存里,新文当然漏。
把 sitemap 改成动态增量接口
我不再依赖打包时生成全量 sitemap,而是在 Nuxt 3 服务端加一个 XML 路由:每次请求时从 MongoDB 查已发布、非草稿、发布时间已到的文章。为了不打数据库,我用 Redis 缓存 5 分钟,发布文章时主动删除缓存。这样新文入库后,sitemap 下一次请求就能带上,而不是等重新部署。
lastmod 别只用 createdAt
- 只输出 status 为 published 且 publishedAt 小于当前时间的文章,避免草稿和定时文章提前漏出。
- lastmod 使用 updatedAt,而不是 createdAt;正文修改、标签调整、封面替换都应刷新更新时间。
- 数据库统一存 UTC 时间,展示层再做时区转换,避免 sitemap 时间和文章页时间看起来对不上。
- 文章多时拆成 sitemap 分页或索引,别把所有 URL 塞进一个文件。
发布后主动推送,别只等爬虫
export default defineEventHandler(async (event) => {
const db = await useMongoDb(); // 以你项目里的连接方式为准
const posts = await db.collection('posts')
.find({ status: 'published', publishedAt: { $lte: new Date() } })
.project({ slug: 1, updatedAt: 1 })
.sort({ updatedAt: -1 })
.limit(200)
.toArray();
const urls = posts.map((p) => {
return `<url><loc>https://blog.example.com/${p.slug}</loc><lastmod>${p.updatedAt.toISOString()}</lastmod></url>`;
}).join('');
setHeader(event, 'content-type', 'application/xml');
return `<?xml version='1.0'?><urlset xmlns='http://www.sitemaps.org/schemas/sitemap/0.9'>${urls}</urlset>`;
});光有 sitemap 还不够。我的做法是文章发布或更新成功后,异步触发推送任务:先查 Redis 是否最近推过同一个 URL,避免重复;再调用搜索平台提供的提交接口。接口失败不阻塞发布,写入重试队列。主动推送不是玄学,它至少能缩短新链接被发现的窗口;具体接口字段和限制,以官方文档为准。
“这次修复给我的提醒:SEO 不是一个页面配置,而是一条数据链路。文章入库、状态判断、lastmod 更新、sitemap 缓存、主动推送,每一环断了都会表现为“收录慢”或“漏文章”。”
现在我的 Nuxt 3 博客 sitemap 不再是一个神秘静态文件,而是由发布流程驱动的动态结果。新文章发布后,缓存失效、sitemap 更新、推送重试,整个闭环能在几分钟内完成。对独立博客来说,这种小工程化改造比反复换插件更有用。