结构化数据里的 image 写成 /uploads/1.jpg,测试工具提示图片地址无效,富媒体预览里也没有图。

排查方向其实有限,先把可能性排一排。相对路径无法被解析成完整地址。少数情况下是图片域名和页面域名不同,未写完整协议。

不容易想到的是,图片被 CDN 做了防盗链,外部抓取失败。

第一件事是检查 image 字段的实际值

curl -s https://www.example.com/a/ | grep -o '"image".*'

再往下改成完整绝对地址

"image": "https://www.example.com/uploads/1.jpg"

剩下的就是确认图片可直接访问

curl -sI https://www.example.com/uploads/1.jpg | head -1

命令输出我都留了记录,免得改完记不清原来的值。

改之前先确认了最近有没有人动过配置,避免白查一遍。

这次没动代码,只在配置和运行环境上找原因。

别只看报错消失,验证要多做一步。工具能读取到图片,富媒体预览里正常显示配图。

结构化数据里的资源地址一律用绝对路径,相对路径在 AMP、多域名、CDN 场景下几乎都会解析失败,且不会给出明确报错,排查成本很高。拖得越久,排查成本越高,因为现场状态会被后续操作覆盖。

作者 9823189