面包屑结构化数据提交了 120 天,GSC 的「面包屑」增强报告一直是 0 个有效项目,错误栏写着「无法解析」。页面上看得见首页 > 分类 > 文章,用户视角完全正常。
问题在 JSON-LD 里,三处错误叠在一起。第一处是 position 从 0 开始,规范要求从 1 起,我从 0 起,整段判无效。第二处是 item 用了相对路径 /category/seo/,要求绝对 URL。第三处是最后一级也写了 item 指向当前页,这条本身不算错,但配合前两处,解析器在第一项就停了。
<script type="application/ld+json">
{"@context":"https://schema.org","@type":"BreadcrumbList",
"itemListElement":[{"@type":"ListItem","position":1,
"name":"首页","item":"https://ex.com/"}]}
</script>
排查要看渲染后的 HTML,不是源码。有些主题把 JSON-LD 塞在 body 末尾再被 JS 重写一遍,源码对、渲染错。我这次就是源码对渲染错,多花一天才反应过来。
还有个容易忽略的点:类型必须是 BreadcRUMbList。写成 ItemList,或者在 WebPage 里塞 itemListElement,语法上都能过校验器,但只有 BreadcrumbList 会进面包屑报告。三种写法长得像,结果差很远。
这个站的分类页有 4 级,第 4 级是标签。标签页当时也提交了,可标签和分类在层级上并列,解析出来的路径是断的,后来把标签从面包屑里去掉,只留三级。
提交后前两天报告不会动,GSC 的增强功能是每周重算一次。等到第 7 天还是 0 有效项目,去查抓取才发现新 URL 根本没被抓,sitemap 还是旧的,重新提交才动起来。
改完重新提交,第 14 天报告里出现 860 个有效项目,错误归零。搜索结果里的面包屑要到第 20 天才陆续出现,不是提交完立刻变。
现在的检查方式是一条命令:把页面丢给富媒体结果测试,看面包屑那一栏能不能解析出三条层级。解析出来了就说明没写错。
