itemtype必须是完整HTTPS URL且返回200,itemscope须包裹itemtype并置于块级元素,itemprop需绑定机器可读值,类型须匹配页面核心内容。

itemtype必须是完整 HTTPS URL,少一个字符都不行
Google 和 WHATWG 解析器强制要求 itemtype 值必须是可访问的、协议为 https 的绝对 URL,且该 URL 在 HTTP 层需返回 200 状态码(哪怕内容只是 HTML 页面)。写成 http://schema.org/Person、schema.org/Person、Person 或 https://schema.org/Person/(末尾多斜杠)都会导致整块微数据被忽略。
常见错误包括:
- 复制链接时漏掉
s,变成http协议 - 从文档里抄了缩写,如直接写
Product - 本地开发时用
./vocab或相对路径 - 拼错域名,比如
schmea.org或大小写混用(https://Schema.org/Article)
itemscope 必须包裹 itemtype,且不能跨层断开
itemtype 只在带有 itemscope 的元素上起作用,而且这个 itemscope 必须出现在最外层容器(如 <div>、<code><section></section>),不能藏在中间某层 wrapper 里。一旦 itemprop 元素和它的 itemscope 祖先之间隔了一个没声明任何 microdata 的 <div>,解析器就找不到归属,整个属性链就断了。
<p>正确结构示例:</p>
<p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记(深入)</a>”;</p>
<pre class="brush:php;toolbar:false;"><div itemscope itemtype="https://schema.org/LocalBusiness">
<h1 itemprop="name">某某公司</h1>
<div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
<span itemprop="streetAddress">XX路1号</span>
</div>
</div></pre>
<p>错误模式:</p>
<ul>
<li>只给 <code><h1 itemprop="name"></h1> 加 itemprop,但外层没有 itemscope + itemtype
itemscope 放在 <article></article>,但 itemprop="name" 写在嵌套的 <p></p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20cf0281539.jpg" alt="AgentGen — HTML to PDF & Image" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image">AgentGen — HTML to PDF & Image</a>
<p>将 HTML 转换为 PDF 和图片。无需注册,免费版开箱即用(每分钟 1 次请求,含水印)。如需更高频次及去水印……</p>
</div>
<a href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div> 里,中间夹着一个无 microdata 的 <div class="wrapper">
<li>用 <code><span itemscope itemtype="..."></span> 当外层容器——<span></span> 不是合法的 scope 容器,应优先选块级元素Google Rich Results Test 报错但页面看着“没问题”?检查 itemtype 是否匹配页面意图
即使 itemtype 语法全对、URL 可访问,Google 仍可能在测试工具里报“未检测到结构化数据”或“类型不匹配”。根本原因是:你选的类型和页面主体不一致。比如企业首页硬套 https://schema.org/Product,或新闻详情页用了 https://schema.org/Organization,Google 会认为语义冲突,主动降权或忽略。
判断依据很简单:
- 用户打开这个页面,最想了解的是什么?是买一件商品?查一家公司?读一篇报道?
- 页面核心内容是否完整覆盖该类型必需字段?例如
LocalBusiness至少要有name、address;Article至少要有headline、datePublished - 避免“越具体越好”的误区:
https://schema.org/Restaurant是LocalBusiness的子类,但如果页面没展示营业时间、菜单、预订入口,用 Restaurant 反而增加验证失败风险
为什么加了 itemtype 还是没富媒体结果?别漏掉 itemprop 的绑定细节
itemtype 定义了“这是什么”,但没定义“它有什么”。如果所有 itemprop 都绑在文本内容上,而 URL、日期、价格这些关键字段没用 href、datetime、content 显式提供机器可读值,Google 就无法提取结构化信息——它不会猜“¥99.99”是不是价格,“2024-05-20”是不是发布日期。
典型疏漏点:
-
<a itemprop="url">官网</a>→ 缺href,实际提取到的是“官网”字符串,不是链接 -
<time>2024年5月20日</time>→ 没加datetime属性,日期格式不统一,易被忽略 -
<div itemprop="price">¥29.99</div>→ 没用content="29.99",货币符号干扰数值识别 - 多关键词用逗号写在一个
<meta>里:<meta itemprop="keywords" content="前端,HTML,CSS">→ 应拆成多个<span itemprop="keywords">前端</span>
真正生效的微数据,是 itemscope、itemtype、itemprop 三者严丝合缝,且每个 itemprop 的值都经得起机器解析——不是“看起来像”,而是“明确告诉搜索引擎这是什么”。


















