Next.js 动态 SEO 必须服务端直出元数据,因爬虫只解析初始 HTML;应使用 generateMetadata 函数在 Server Component 中同步生成,避免 useEffect 等客户端修改。

不能靠 JS 客户端生成,必须服务端直出;否则 Googlebot 抓到的几乎总是空值或模板默认值。
Next.js / Nuxt 等 SSR 框架里,description 为什么总被忽略
根本原因不是代码写错,而是渲染时机不对:旧版 Googlebot 不执行 JS,只解析初始 HTML 字符串。如果你用 useEffect 或 mounted 去改 ,它看到的永远是占位内容。
- Next.js 必须在
getStaticProps或getServerSideProps中注入description字段,并通过next/head或新版generateMetadataAPI 渲染 - Nuxt 3 推荐用
useSeoMeta,且需确保参数在setup()或definePageMeta中同步提供,而非异步 fetch 后才设 - 若页面依赖 CMS 数据(如 Strapi、Sanity),务必确认 API 调用发生在服务端阶段,而不是组件挂载后
VuePress / VitePress 动态 description 的坑在哪
它们支持 frontmatter 配置 description: "xxx",但这个字段是否生效,取决于主题是否主动读取并注入到 —— 很多自定义主题压根没处理这行。
- 检查你用的主题源码中是否有类似
Head.append()的逻辑 - 若使用
vitepress-plugin-frontmatter类插件,确认其配置未覆盖或清空原始description - 本地开发时用
curl -s http://localhost:5173 | grep description直接看返回 HTML 是否含真实值,别信浏览器开发者工具里 JS 更新后的 DOM
CMS 或静态站批量生成 description 的安全边界
人工写几百页不现实,但无约束的模板拼接极易产出雷同、超长、关键词堆砌的内容——Google 会直接弃用,转而抓取正文片段。
- 电商详情页:严格用
${product.name} | ${product.specs.join(', ')} | ${product.warranty},禁用全局site.description - 博客列表页(/blog):可省略
description,让搜索引擎自动提取;但分页页(/blog?page=2)必须加 - 所有生成逻辑必须带长度截断:后端入库前用
str.substring(0, 160)(注意是 Unicode 字符,不是字节),前端编辑器需实时显示剩余字符数 - 避免把
文本原样复制进content,要重写成动词开头句式,例如:“修复JSON.parse解析带注释 JSON 失败的问题”
最常被绕开的一环是:即使你服务端生成了合规的 description,只要首屏 HTML 里的 或第一段文本在 JS 加载后被动态替换,Google 仍可能判定“内容不匹配”,从而弃用该 meta 标签。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











