博客系统自文档 · SEO、搜索与发现增强

博客系统自文档 · 附录 B / 19 篇
目录 · 上一篇：互动与社区（评论/留言/收藏） · 下一篇：支付、邮件与运营支撑

写在前面

第 02 篇介绍了路由级「发现」；本篇专门讲 搜索引擎与订阅器 如何抓取你的站，以及 搜索页 的技术路径。

范围说明：SSR、RSS、sitemap、JSON-LD 均在 blog-home-nuxt 实现；uni-app 小程序/H5 不走同一套 SEO 管线，公开收录以 Web 为准。

功能与体验

2026 详情页 SEO 组件

• ArticleShareBar — 分享传播
• ArticleRelated — 内链增加爬取深度
• 同作者 prev/next — 串联专栏 URL

设计与实现

三条发现通道对比

RSS（运行时）

// feed.xml.ts 核心：直连 Nest API
const apiPrefix = process.env.VITE_NUXT_API_PREFIX || '/x-blog/api/v1';
$fetch(`${origin}${apiPrefix}/article/list`, { method: 'POST', body: { page: 1, pageSize: 50, client: true } })
// 响应：res.data.list（TransformInterceptor 包装）

RSS 由 Nitro 路由提供 XML，数据请求直达 /x-blog/api/v1/article/list（Nginx → Nest）。

Sitemap（构建时 + 动态源）

配置于 nuxt.config.ts：

sitemap: {
  sources: ['/api/__sitemap__/urls'],
}

server/api/__sitemap__/urls.ts 在生成 sitemap 时：

1. POST /article/list（pageSize 500）→ /detail/{id}
2. GET /rpg/leaderboard?type=exp&limit=50&period=total → /user/{uid}（去重）

注意：dev 环境行为与生产 build 不同；发版后新文章/新上榜用户需 rebuild Nuxt 才会进 sitemap（RSS 无需 rebuild）。

JSON-LD / canonical

pages/detail/[id].vue 内 useHead 注入：

• BlogPosting 或等效 schema（标题、描述、时间）
• canonical 指向规范 URL

搜索

• 前端 /search 统一入口（2026-06 三批）
• 后端 article/list 带 keyword 条件（标题/内容模糊）
• 公开接口，需 RBAC isPublic=1
• uni-app /pages/search/search 调同一 API，不参与 sitemap

踩坑与取舍

1. Sitemap 与 RSS 不同步策略：RSS 实时、sitemap 随 build — 新文上线后若重视 SEO，记得 Home rebuild。
2. feed.xml 与 sitemap 域名：生产 siteOrigin 配置需与 canonical 一致。
3. SSR 保留文章列表 HTML（第 14 篇）：爬虫仍能看到首页/列表骨架。
4. 小程序 SEO：微信搜一搜依赖小程序自身配置，与 Web sitemap 无关。

系列导航

• 目录：博客系统分类
• 上一篇：16 互动与社区（评论/留言/收藏）
• 下一篇：18 支付、邮件与运营支撑
• 导读：导读 · 第 0 篇

延伸阅读

• blog-home-nuxt/server/api/__sitemap__/urls.ts
• blog-home-nuxt/server/routes/feed.xml.ts
• blog-home-nuxt/nuxt.config.ts（sitemap 配置）