itemtype必须是完整HTTPS URL，不能用相对路径；须为https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937后接精确类型（如Product），末尾无斜杠，协议、域名、路径任一字符错误均导致整块微数据被忽略。
itemtype 必须是完整 HTTPS URL，不能用相对路径
Google 和所有主流结构化数据解析器（包括 Rich Results Test）明确拒绝任何非绝对 HTTPS 的 itemtype 值。写成 ./Product、schema/Product、Person 或甚至 //schema.org/Product（协议相对路径）都会直接导致整个 itemscope 块被忽略——你不会看到报错提示，但结构化数据在测试工具里就是“不存在”。
这不是浏览器兼容性问题，而是规范强制要求：该值必须是一个可 HTTP 访问的、返回 200 状态码的 HTTPS URL（哪怕页面内容只是 HTML 文档，不是 JSON-LD）。
-
✅ 正确：itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Product"（末尾无斜杠） -
❌ 错误：itemtype="http://schema.org/Product"（HTTP 协议已不被接受） -
❌ 错误：itemtype="/vocab/product"（相对路径，解析失败） -
❌ 错误：itemtype="Product"（纯字符串，无意义）
为什么拼错一个字符或少个 s 就失效
itemtype 的作用不是“样式”或“JS 触发”，它是给机器读的类型声明。解析器会尝试对这个 URL 做一次轻量级验证：发起 HEAD 请求，检查是否返回 200（或 301/302 重定向到有效地址）。一旦协议错、域名错、路径错，或者目标服务器返回 404/500，就判定词汇表不可信，整块微数据作废。
常见手误包括：
立即学习“前端免费学习笔记（深入）”；
- 把
https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937误写成https://www.schema.org/（多了一个 www） - 复制粘贴时漏掉末尾的
Product，只剩https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937（末尾带斜杠） - 从旧文档抄了已停用的
http://data-vocabulary.org/（Google 自 2026 年起完全弃用）
如何快速验证 itemtype 是否生效
别依赖肉眼检查 HTML 源码。真实有效的验证方式只有两个：
- 打开 Google Rich Results Test，粘贴 URL 或代码片段，看是否识别出结构化数据类型和字段
- 在 Chrome DevTools 的 Elements 面板中右键含
itemscope的元素 → “Copy” → “Copy outerHTML”，然后粘贴到测试工具中，排除服务端渲染干扰
如果测试工具显示“未检测到结构化数据”，且你确认用了 itemscope，那 95% 的概率就是 itemtype URL 本身有问题——先检查协议、域名、路径三者是否与 schema.org 官网 展示的完全一致，一个字母都不能差。
Django / React 项目里容易被忽略的部署陷阱
本地开发时可能一切正常，但部署后 itemtype 突然失效。这不是代码问题，而是环境差异：
- 某些 CDN 或代理层会拦截或改写对
https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937的 HEAD 请求（例如返回 403），导致解析器判定 URL 不可用 - 内网环境或企业防火墙可能屏蔽外部 HTTPS 请求，使验证失败
- 使用了错误的模板语法（如 Django 中写成
{% static 'https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Product' %}），结果输出成了/static/https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Product
最稳妥的做法：永远手动写死标准 URL，不要用任何模板变量或构建时替换逻辑去生成 itemtype 值——它本就不该动态。
