富媒体摘要需显式嵌入JSON-LD结构化数据于<head>或<body>顶部，且datePublished、image、headline、author等字段必须完整准确并与DOM严格一致，否则降级为普通摘要。
富媒体摘要不会自动从 HTML 文本里“读出来”，必须显式嵌入结构化数据，且仅 JSON-LD 格式能稳定触发 Google 等主流引擎的富媒体卡片（如文章摘要带图、发布时间、作者）。
JSON-LD 必须写在 <head> 或 <body> 顶部
搜索引擎解析器按顺序扫描 HTML，遇到第一个有效的 <script type="application/ld+json"> 就停止——后面同类型脚本会被忽略。动态注入（比如用 document.createElement("script") 在 window.onload 后追加）大概率不被爬虫执行。
- 服务端渲染（SSR）或静态生成（SSG）时直接输出到
<head>最可靠 - 若必须前端注入，请确保在
<body>开头、任何内容前插入，且不要包裹在async或defer脚本中 - 避免和 Google Analytics、Clarity 等第三方脚本混在一起，防止被误删或压缩破坏 JSON 格式
datePublished 和 <time datetime> 必须完全一致
Google 会交叉校验 JSON-LD 中的 datePublished 和页面 DOM 里的 <time datetime> 值。哪怕只差一个空格或时区符号（如 +08:00 vs +0800），都可能被判定为不一致，导致富媒体降级为普通摘要。
-
datetime属性值必须是 ISO 8601 完整格式，例如"2024-05-20T14:30:00+08:00"，不能省略秒或时区 - 别用
new Date().toISOString()直接塞进 JSON-LD——它默认输出 UTC 时间（Z），而页面<time>显示的是本地时间，极易错位 - 服务端生成时统一用带时区的字符串，前端 JS 只负责显示“X 分钟前”，不参与结构化数据构造
image 字段必须是可公开访问的绝对 URL 数组
富媒体摘要里的图片不是靠 <img src> 自动抓取的，而是严格读取 JSON-LD 中 image 字段指定的地址。如果该 URL 返回 403、404 或重定向到登录页，图片候选直接被剔除。
立即学习“前端免费学习笔记（深入）”；
- 字段值必须是字符串数组，哪怕只有一张图也要写成
"image": ["https://example.com/cover.jpg"]，不能是单个字符串 - URL 必须以
http://或https://开头，相对路径（如/img/cover.jpg）或协议相对路径（//cdn.example.com/cover.jpg）在线上抓取时失效 - 图片需满足最低尺寸（建议 ≥1200×630 像素）、返回 200 状态码、支持 CORS（尤其跨域 CDN）
字段缺失比格式错误更致命
Google 的富媒体测试工具（URL Inspection → Test Live URL → View Rich Results）对缺失字段是硬性拦截：只要 @type 是 "Article"，就要求 headline、datePublished、author 全部存在，缺一不可；而格式错误（如日期少个冒号）有时还能宽容解析。
-
author不能留空，哪怕匿名也得写成"author": { "@type": "Person", "name": "Anonymous" } -
headline必须和页面<h1>文本逐字一致（空格、标点、大小写均敏感），不能是截断版或 SEO 改写版 - 所有键名必须用双引号包裹，
'@type': 'Article'或@type: "Article"都会解析失败
最容易被忽略的是“一致性”——不是写了 JSON-LD 就万事大吉，而是 DOM 内容、HTML 语义标签、结构化数据三者必须像齿轮一样咬合。任何一处松动，富媒体摘要就退回到纯文本 snippet。
