itemtype值必须是可访问的https url,否则itemscope块会被忽略;需用google rich results test验证url可达性及结构合法性,并确保itemprop与itemtype匹配且嵌套正确。

itemtype值不是“能写就行”,必须是可访问的HTTPS URL
Google 和其他结构化数据解析器在读取 itemtype 时,会尝试 HTTP HEAD 请求该 URL。哪怕页面返回的是 HTML(比如 schema.org 的类型页),只要状态码是 200,就认为有效;如果返回 404、301(非 HTTPS)、连接超时或协议写成 http://,整个 itemscope 块会被直接忽略。
常见错误包括:
-
itemtype="http://schema.org/Person"→ 协议错误,主流工具已拒绝 HTTP -
itemtype="schema.org/Person"→ 缺少协议和域名,不是完整 URL -
itemtype="./vocab/Event"→ 相对路径,无法被外部解析器验证 -
itemtype="Person"→ 纯字符串,无语义,不指向任何词汇表
用 Google Rich Results Test 实时验证是否生效
这是目前最可靠、最贴近真实搜索引擎行为的检查方式。它不只看语法,还会模拟爬虫请求 itemtype URL 并校验响应头。
操作要点:
- 把含
itemscope的 HTML 片段粘贴进测试框,或输入线上 URL - 点击“运行测试”,等待结果
- 若报错 “
itemtypeis not a valid URL” 或 “Failed to fetch itemtype”,说明 URL 不可达或协议错误 - 若显示 “No rich results detected”,但没报
itemtype错误,说明 URL 可访问,但内部结构(如itemprop拼写、嵌套位置)可能有问题
检查 itemtype 是否与 itemprop 匹配
itemtype 不是万能容器,它定义了“合法属性白名单”。比如 itemtype="https://www.php.cn/link/2ad908ea29b45df4bf8b2a3136690429" 下,itemprop="telephone" 合法,但 itemprop="price" 就会报错——后者只在 Offer 或 Product 类型中定义。
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图,自动匹配视觉风格。触发场景:文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
查证方法很简单:
- 打开
itemtype对应的 schema.org 页面,例如 https://www.php.cn/link/2ad908ea29b45df4bf8b2a3136690429 - 滚动到 “Properties” 表格,确认你要用的
itemprop名称是否在列,且 “Expected Type” 列符合你的实际值类型(如 URL、Text、Date) - 注意大小写:schema.org 属性名全小写,
itemprop="name"正确,itemprop="Name"无效
嵌套时 itemtype 必须紧贴 itemprop 所在元素
当某个属性本身是另一个实体(如作者、地址、评论),必须让 itemprop 和嵌套的 itemscope itemtype 在同一 DOM 元素上,中间不能隔层。
错误写法(Google 会丢弃整个嵌套):
<div itemprop="author"> <div itemscope itemtype="https://www.php.cn/link/2ad908ea29b45df4bf8b2a3136690429">张三</div> </div>
正确写法(itemprop 和 itemscope itemtype 同元素):
<div itemprop="author" itemscope itemtype="https://www.php.cn/link/2ad908ea29b45df4bf8b2a3136690429">张三</div>
这种结构松动是富媒体摘要失败最常见的原因之一,尤其在动态生成 HTML 时容易漏掉绑定层级。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










