事情本身不复杂,线索都在日志里。教程页的 HowTo 标记在桌面搜索里能显示步骤,移动端搜索结果里完全看不到这个模块。
排查方向其实有限,先把可能性排一排。移动端页面把步骤折叠进了标签页,内容不可见。少数情况下是移动版输出的结构化数据和桌面版不一致。
不容易想到的是,步骤图片在移动端被隐藏,图片字段失效。
上来先对比两个版本的输出
curl -s -A 'Mozilla/5.0 (iPhone)' https://www.example.com/how/ | grep -c 'HowToStep'
随后确保步骤内容在移动端也可见
curl -s https://www.example.com/how/ | grep -c 'display:none'
等前面都确认过,再统一两端的结构化数据输出
add_action('wp_head', 'print_howto_schema');
中间停过一次,把已经改的东西回滚干净,再重新来一遍。
恢复的判定其实很直接。移动端也能检测到完整的步骤标记,搜索结果里出现步骤列表。
提醒一点。HowTo 富媒体目前主要出现在部分地区和设备上,即使标记正确也不保证展示,优先级不必放太高。报错文案容易误导,真正的原因往往在相邻那一层的日志里。