面包屑标记里 item 写成 /category/seo/，富媒体测试提示 URL 无效，页面上看得见的面包屑却完全正常。第一次遇到会往复杂处想，其实漏掉的多是个小前提。
"itemListElement": [{
"@type": "ListItem", "position": 1,
"name": "SEO", "item": "https://www.example.com/seo/"
}]
结构化数据的 item 要求绝对地址，相对路径在 JSON-LD 里不会被自动补全。模板直接复用了页面上的 href，两套规则并不一样。这一点先确认清楚，后面就不用反复试。
「面包屑相对路径」相关的日志我一般连着看前后五分钟，单看一条报错经常判断不出是哪一步失败。把复现步骤压到三条以内，交给同事也能跑出来，才算真的定位清楚。
改动写完就同步给同事，下一个人踩同一个坑，成本还是你的。验证用真实数据走一遍，测试数据太干净，边界情况根本碰不到。
能分两步做的操作就别合成一步，中间看一眼返回值，出问题好判断。
具体做法是，item 用 home_url 拼成完整地址；position 从 1 开始连续编号，不要跳号；最后一级可以只给 name 不给 item；改完逐页跑一遍富媒体测试。
改完照着核一遍，富媒体测试里面包屑条目全部通过，结果里能显示完整层级。