报错是这么冒出来的。WooCommerce 9.3 升级后主题覆写了商品页模板,Search Console 的商品摘要有效条目从 2.4 万条掉到 0,报错是「缺少字段 offers」。试过停用 SEO 插件、重装结构化数据模块、在 GSC 里重新校验,一周后仍然是 0,页面源码里只剩 name 和 image。
中间走过弯路,把「priceCurrency 用了站点货币符号而不是 ISO 4217 代码」当成主因,改完现象没变。
真正麻烦的地方在于,几个原因的现象几乎一样。模板覆写把 wc_get_structured_data 的输出整段替换掉了。也可能是可变商品没有价格区间,offers 里的 lowPrice 为空被判缺失。
另外,availability 输出成中文「有货」,枚举值不合法。
第一件事是确认页面里到底输出了哪些字段
curl -s https://www.example.com/product/a | grep -o 'application/ld+json'
随后把 JSON-LD 抽出来做语法和字段校验
curl -s https://www.example.com/product/a | python -m json.tool | head -40
再往下在模板里恢复 WooCommerce 原生结构化数据钩子
add_action('wp_footer', 'wc_structured_data_product');
给可变商品补上价格区间和库存枚举
curl -s https://www.example.com/product/a | grep -i lowPrice
怎么算真的好了,看的是同一批现象。校验工具不再报缺少 offers,GSC 商品摘要有效条目在两周内回到 2 万条以上,价格与后台一致。
提醒一点。改模板时最容易被整段覆盖的就是 JSON-LD,升级前先 diff 一遍主题里的 woocommerce 目录。线上能稳定复现的问题都不算难,难的是只在大流量下才出现的那种。
