{"@type":"ItemList","itemListElement":[{"@type":"ListItem","position":1,"url":"https://example.com/p/1"}]}

目录页拿去 Rich Results Test 检测,Product 卡片全部报 Missing field offers,ItemList 里 24 个条目一个都没通过。这类现象通常不是突然出现的,往前翻半天日志能看到苗头。

追下去是这么回事:模板只在详情页输出 Product 的 JSON-LD,目录页复用了同一段但没带价格和库存,offers 整块被跳过。ItemList 的 itemListElement 里又只写了 name 一个字段。

围绕「目录结构化数据」排查时,命令行跑一遍比在面板里点十次有用,面板会替你做掉不少隐式操作。监控和日志的时间要对上,时区不一致会多绕很大一圈。

临时改动用注释写上日期和原因,过两周自己都记不清为什么这么写。动手前把原文件复制一份带时间戳,出问题立刻换回去,比现场分析快得多。

一次只改一处,改完立刻验证,几个改动叠在一起,出问题就说不清是谁导致的。

处理上按这个顺序:目录页改成 ItemList,每个 item 的 url 指向详情页,别塞半成品 Product;要给 Product 就补全 offers、priceCurrency 和 availability;改完重跑测试,重点看 itemListElement 的数量。

确认没问题再收工,检测结果里 ItemList 通过,24 个条目全部带 url,不再提示 Missing field offers。

作者 9823189