Nuxt 3 博客富摘要不显示作者:我用 JSON-LD、useHead 去重和结构化校验修好搜索结果展示
文章页富摘要没有作者,不一定是没写结构化数据,可能是多份 JSON-LD 冲突、字段兜底缺失和线上缓存旧输出。这里记录我用统一模板、useHead key 去重和校验工具修复的过程。

作者
ZHOUYI
博客上线一段时间后,我发现文章页在搜索结果里经常不显示作者富摘要。起初以为是模板没写 author,但查看源码才发现:页面里同时存在多段 JSON-LD,有的来自全局 useHead,有的来自文章组件,字段格式也不一致。搜索引擎拿到一份不完整或互相冲突的数据,自然不如预期。
先把结构化数据收敛成一份
我把 Article、Author、Breadcrumb 的生成逻辑收到一个 composable 里,只在文章详情页调用一次。useHead 的 script 加 key,避免 Nuxt 在路由切换或组件重复渲染时注入多份。同时把 @type 固定为 Article,作者统一为 Person 对象,不再混用字符串。
export function useArticleJsonLd(post) {
const author = { '@type': 'Person', name: post.author?.name || '作者' }
const data = {
'@context': 'https://schema.org',
'@type': 'Article',
headline: post.title,
author,
image: post.cover || '/default-cover.jpg',
datePublished: post.publishedAt,
dateModified: post.updatedAt || post.publishedAt
}
useHead({ script: [{ key: 'article-jsonld', type: 'application/ld+json', innerHTML: JSON.stringify(data) }] })
}字段兜底:别让空值毁掉摘要
第二类坑是字段缺失。作者名为空时,我回退到站点作者;updatedAt 缺失时,用 publishedAt 兜底;面包屑按路由生成,并给每一项补上 name 和 item。图片也设置默认封面,避免 Article 因关键字段不完整而降级。
- author 缺失:回退站点作者,避免空字符串
- 日期缺失:dateModified 优先取 updatedAt,否则取 publishedAt
- BreadcrumbList:从栏目到文章逐级生成,名称过长截断
- 封面缺失:使用默认 OG 图,保证图片字段可用
线上校验:看 SSR 最终 HTML,不只看本地
本地正常不代表线上正常。我把渲染后的 HTML 拉下来检查唯一 JSON-LD,再用结构化数据校验工具看 author 是否识别。最后清掉 CDN 缓存,观察搜索控制台变化。这里别急着归因,搜索引擎更新展示会有延迟,以官方文档和实际抓取为准。
“结构化数据不是写一段 script 就完事,而是要保证唯一注入、字段完整、线上可校验。”
这次修复后,文章页的作者、日期和面包屑都稳定进入富摘要。回头看,最关键的是把结构化数据当成接口输出来维护:统一模板、兜底字段、去重注入、持续校验。对独立博客来说,这类小改动往往能直接改善搜索展示和点击。