问题出现得很突然，日志倒是留得挺全。视频详情页的标记里有 name、description、thumbnailUrl、contentUrl，测试工具全部通过，搜索结果里却始终只有一条普通链接。视频 tab 里能搜到页面，但没有缩略图和时长信息，GSC 的视频增强报告是空的。
刚开始盯着「duration 用了中文时长描述 没有转成 ISO 8601 格式」，折腾了半个多小时，排掉了。
排查方向其实有限，先把可能性排一排。embedUrl 缺失 蜘蛛无法确认可播放的嵌入地址。另一种情况是contentUrl 指向 m3u8 分片 不是单个可下载的视频文件。
少数情况下是video 标记放在了正文之外 与页面主体不在同一个 JSON-LD 块。
上来先看当前页面输出了哪些视频字段
curl -s https://www.example.com/video/123 | grep -o '"@type": "VideoObject".*' | head -c 400补上标准的嵌入地址
"embedUrl": "https://www.example.com/embed/123"接着把时长转成 ISO 8601
echo 'PT' . intdiv($sec, 60) . 'M' . ($sec % 60) . 'S';等前面都确认过，再用富媒体测试复验后提交索引
curl -s -X POST 'https://www.example.com/api/reindex?id=123'怎么算真的好了，看的是同一批现象。补齐 embedUrl 和规范时长后重新抓取，视频在搜索结果里开始带缩略图和时长，视频增强报告里出现了有效条目。
提醒一点。视频标记缺 embedUrl 时工具可能不报错，但富媒体基本不会出现，这是通过测试和真正生效之间的差距。拖得越久，排查成本越高，因为现场状态会被后续操作覆盖。