先看现象。文章页的 JSON-LD 在富媒体测试里全部通过,GSC 的增强功能却显示有效项为 0,报告里只有一片空白。
把日志和配置对完,能解释这个现象的基本就这几处。测试工具看的是单个 URL,报告统计的是全站,模板只在部分页面输出。还有一种是JSON-LD 被主题的延迟加载脚本挪到了 noscript 里。
另外,页面类型被判成列表页,Article 标记和页面主体不符。
少数情况下是报告按文章模板分组,采样周期内没有抓到带标记的样本。
第一件事是抽三个不同模板的页面逐一看源码
curl -s https://www.example.com/post/1 | grep -c 'application/ld+json'
校验 JSON-LD 能否被正常解析
curl -s https://www.example.com/post/1 | sed -n '/ld+json/,/<\/script>/p' | tail -n +2 | head -n -1 | python -m json.tool
末了确认输出位置在 head 或 body 首屏
curl -s https://www.example.com/post/1 | grep -n 'application/ld+json'
恢复的判定其实很直接。补齐模板判断后,GSC 的 Article 有效项在一周内从 0 涨到 1.2 万,缺失字段的提示也清零。
增强功能报告只统计被抽样抓取的页面,测试通过不代表全站生效,务必按模板分别抽检。同一份配置在测试环境跑通,不代表线上没事,两边的默认值经常不一样。
