如何处理网站的`结构化数据`错误？ - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

结构化数据错误诊断与修复：一场代码层面的深度剖析

各位同学，大家好！今天我们来聊聊网站结构化数据错误的处理。结构化数据对于搜索引擎优化（SEO）至关重要，它能帮助搜索引擎更好地理解网页内容，从而在搜索结果中更准确地展示信息。但错误时有发生，需要我们具备诊断和修复的能力。

一、结构化数据的必要性与常见格式

首先，我们来回顾一下结构化数据的意义。搜索引擎蜘蛛通过抓取网页的HTML代码来理解内容，但HTML主要关注的是内容的呈现方式，而非内容的语义。结构化数据则通过预定义的词汇表（Schema.org）来描述网页内容的类型、属性和关系，使得搜索引擎能更准确地理解网页的含义，从而在搜索结果中展示更丰富的信息，如星级评分、价格、作者等等，这被称为“富摘要”（Rich Snippets）。

常见的结构化数据格式有三种：

JSON-LD (JavaScript Object Notation for Linked Data): 谷歌推荐的格式，易于实现和维护，独立于HTML结构，推荐使用。
Microdata: 嵌入到HTML标签中，需要修改HTML结构，维护成本较高。
RDFa (Resource Description Framework in Attributes): 类似于Microdata，同样嵌入到HTML标签中。

在今天的讨论中，我们将重点关注JSON-LD格式，因为它更简洁、更灵活。

二、常见的结构化数据错误类型

结构化数据错误五花八门，但可以归纳为以下几类：

语法错误 (Syntax Errors): JSON-LD格式不正确，例如缺少逗号、引号不匹配、括号不匹配等。
必需属性缺失 (Missing Required Properties): Schema.org定义的类型要求某些属性必须存在，但实际代码中缺失了。
属性值类型错误 (Incorrect Property Value Type): 某个属性的值应该是数字，但实际却是字符串。
属性值格式错误 (Incorrect Property Value Format): 例如，日期格式不符合ISO 8601标准，电话号码格式不正确。
逻辑错误 (Logical Errors): 结构化数据描述的内容与网页实际内容不符。
嵌套错误 (Nesting Errors): 结构化数据嵌套层级不正确，导致搜索引擎无法正确解析。
重复声明 (Duplicate Declarations): 同一个属性被多次声明，导致搜索引擎无法确定哪个是正确的值。
过时属性 (Deprecated Properties): 使用了Schema.org已经弃用的属性。
违反指南 (Violation of Guidelines): 违反了Google等搜索引擎的结构化数据指南，例如标记隐藏内容。
上下文不正确 (Incorrect Context): 结构化数据放在了不合适的页面上，例如把产品结构化数据放在了关于我们页面上。

三、结构化数据错误检测工具

在着手修复错误之前，我们需要找到它们。以下是一些常用的结构化数据检测工具：

Google Rich Results Test (Google 富媒体搜索结果测试): 这是Google官方提供的工具，可以检测网页的结构化数据是否符合Google的规范，并预览富摘要的显示效果。
- 网址：https://search.google.com/test/rich-results
Schema Markup Validator (Schema 标记验证器): 由Schema.org官方提供，可以验证结构化数据的语法是否正确。
- 网址：https://validator.schema.org/
Google Search Console (Google 搜索控制台): 在“增强效果”部分，可以查看网站结构化数据的整体情况，以及存在的错误和警告。
- 网址：https://search.google.com/search-console
第三方SEO工具: 很多第三方SEO工具也提供结构化数据检测功能，例如SEMrush、Ahrefs等。

四、实战：诊断和修复结构化数据错误的步骤

现在，我们通过一个具体的例子，演示如何诊断和修复结构化数据错误。假设我们有一个电商网站，销售书籍，其中一个产品页面的结构化数据如下：

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "The Lord of the Rings",
  "image": [
    "https://example.com/lotr_1.jpg",
    "https://example.com/lotr_2.jpg"
   ],
  "description": "The Lord of the Rings is an epic high-fantasy novel by English author and scholar J. R. R. Tolkien.",
  "sku": "978-0547928227",
  "brand": {
    "@type": "Brand",
    "name": "Houghton Mifflin Harcourt"
  },
  "review": {
    "@type": "Review",
    "reviewRating": {
      "@type": "Rating",
      "ratingValue": "4",
      "bestRating": "5"
    },
    "name": "A great book",
    "author": {
      "@type": "Person",
      "name": "John Doe"
    },
    "reviewBody": "I really enjoyed this book. Highly recommended!"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "reviewCount": "100"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/lotr",
    "priceCurrency": "USD",
    "price": "19.99",
    "availability": "https://schema.org/InStock"
  },
  "color": "blue"
}
</script>

使用Google Rich Results Test进行检测：

将上述代码粘贴到Google Rich Results Test中，点击“测试代码”。假设检测结果显示以下错误：
- 错误：缺少“priceValidUntil”属性
- 警告：建议提供“color”属性的更精确值，例如使用色值代码或标准颜色名称。
分析错误信息：
- 缺少“priceValidUntil”属性： 根据Schema.org规范，Offer类型推荐包含priceValidUntil属性，用于指定价格的有效期。
- “color”属性值不精确： 虽然Product类型允许使用color属性，但最好提供更精确的颜色值，例如使用色值代码（#0000FF）或标准颜色名称（blue）。

修复代码：

根据错误信息，我们修改代码如下：

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "The Lord of the Rings",
  "image": [
    "https://example.com/lotr_1.jpg",
    "https://example.com/lotr_2.jpg"
   ],
  "description": "The Lord of the Rings is an epic high-fantasy novel by English author and scholar J. R. R. Tolkien.",
  "sku": "978-0547928227",
  "brand": {
    "@type": "Brand",
    "name": "Houghton Mifflin Harcourt"
  },
  "review": {
    "@type": "Review",
    "reviewRating": {
      "@type": "Rating",
      "ratingValue": "4",
      "bestRating": "5"
    },
    "name": "A great book",
    "author": {
      "@type": "Person",
      "name": "John Doe"
    },
    "reviewBody": "I really enjoyed this book. Highly recommended!"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "reviewCount": "100"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/lotr",
    "priceCurrency": "USD",
    "price": "19.99",
    "priceValidUntil": "2024-12-31", // 添加priceValidUntil属性
    "availability": "https://schema.org/InStock"
  },
  "color": "#0000FF" // 将color属性值修改为色值代码
}
</script>

再次使用Google Rich Results Test进行检测：

将修改后的代码再次粘贴到Google Rich Results Test中，确认所有错误都已解决，警告也已消除。

五、常见错误类型的代码示例与修复方案

接下来，我们针对一些常见的结构化数据错误类型，给出具体的代码示例和修复方案。

错误类型	错误代码示例	修复方案
语法错误	`json { "@context": "https://schema.org/", "@type": "Product" "name": "The Lord of the Rings", }` \| `json { "@context": "https://schema.org/", "@type": "Product", "name": "The Lord of the Rings" }` (添加逗号)
必需属性缺失	`json { "@context": "https://schema.org/", "@type": "Product", "name": "The Lord of the Rings" }` \| `json { "@context": "https://schema.org/", "@type": "Product", "name": "The Lord of the Rings", "description": "An epic fantasy novel" }` (添加description属性)
属性值类型错误	`json { "@context": "https://schema.org/", "@type": "Offer", "price": "USD19.99" }` \| `json { "@context": "https://schema.org/", "@type": "Offer", "price": 19.99 }` (price属性的值应为数字)
属性值格式错误	`json { "@context": "https://schema.org/", "@type": "Event", "startDate": "10/26/2023" }` \| `json { "@context": "https://schema.org/", "@type": "Event", "startDate": "2023-10-26" }` (startDate属性的值应符合ISO 8601标准)
逻辑错误	结构化数据描述的价格与网页实际价格不符。	检查并更新结构化数据中的价格，确保与网页实际价格一致。
嵌套错误	`json { "@context": "https://schema.org/", "@type": "Product", "offers": { "@type": "Product", "price": 19.99 } }` \| `json { "@context": "https://schema.org/", "@type": "Product", "offers": { "@type": "Offer", "price": 19.99 } }` (offers属性的值应为Offer类型)
重复声明	`json { "@context": "https://schema.org/", "@type": "Product", "name": "The Lord of the Rings", "name": "LOTR" }` \| `json { "@context": "https://schema.org/", "@type": "Product", "name": "The Lord of the Rings" }` (删除重复的name属性)
过时属性	使用了Schema.org已经弃用的属性。	查阅Schema.org文档，使用替代属性。
违反指南	标记了隐藏内容。	移除对隐藏内容的标记。
上下文不正确	将产品结构化数据放在了“关于我们”页面上。	将结构化数据放在正确的页面上。
JSON-LD上下文错误	`json { "@context": "http://schema.org/", "@type": "Product", "name": "The Lord of the Rings" }` \| `json { "@context": "https://schema.org/", "@type": "Product", "name": "The Lord of the Rings" }` (确保使用HTTPS协议)

六、动态生成结构化数据的注意事项

在实际项目中，我们通常需要动态生成结构化数据。以下是一些需要注意的事项：

服务端渲染 (Server-Side Rendering, SSR): 使用SSR可以确保搜索引擎在抓取网页时就能获取到完整的结构化数据，避免JavaScript执行延迟导致的问题。
模板引擎: 使用模板引擎（例如：Freemarker, Thymeleaf, Jinja2）可以简化结构化数据的生成过程，并提高代码的可维护性。
数据验证: 在生成结构化数据之前，对数据进行验证，确保数据的类型和格式符合Schema.org规范。
缓存: 对于静态内容，可以使用缓存来提高性能，减少服务器压力。
错误处理: 在生成结构化数据的过程中，需要处理可能出现的错误，例如数据缺失、格式错误等。
更新策略: 当网页内容发生变化时，需要及时更新结构化数据，确保搜索引擎获取到最新的信息。
使用专门的库: 许多编程语言都有专门用于生成结构化数据的库，例如Python的schema-org库。

代码示例 (Python + schema-org库):

from schema_org.Product import Product
from schema_org.Offer import Offer
from schema_org.Brand import Brand

# 创建一个Product对象
product = Product(
    name="The Lord of the Rings",
    description="An epic fantasy novel",
    sku="978-0547928227",
    image="https://example.com/lotr.jpg",
    brand=Brand(name="Houghton Mifflin Harcourt"),
    offers=Offer(
        price=19.99,
        priceCurrency="USD",
        availability="https://schema.org/InStock"
    )
)

# 将Product对象转换为JSON-LD字符串
json_ld = product.to_json()

# 打印JSON-LD字符串
print(json_ld)

七、监控与维护

结构化数据的优化是一个持续的过程。我们需要定期监控网站的结构化数据，及时发现和修复错误。

定期使用Google Search Console: 检查“增强效果”部分，查看是否存在新的错误或警告。
监控富摘要的展示效果: 在Google搜索中搜索网站的关键词，查看富摘要的展示效果是否符合预期。
关注Schema.org的更新: Schema.org会不断更新和完善，我们需要及时了解最新的规范，并更新网站的结构化数据。

八、特殊情况处理

针对特定行业的结构化数据: 不同的行业可能需要使用特定的结构化数据类型和属性。例如，餐饮行业可以使用Restaurant类型，旅游行业可以使用TouristAttraction类型。
多语言网站的结构化数据: 对于多语言网站，需要为每种语言提供相应的结构化数据，可以使用alternateName属性来指定不同语言的名称。

九、进阶技巧

使用sameAs属性: 可以使用sameAs属性将网站的结构化数据与其他网站（例如：Wikipedia, Wikidata）的数据关联起来，从而提高搜索引擎的理解能力。
使用potentialAction属性: 可以使用potentialAction属性来描述用户可以在网页上执行的操作，例如预订、购买等。
利用知识图谱: 深入理解Schema.org背后的知识图谱，可以更有效地利用结构化数据来提高SEO效果。

一些要点总结

结构化数据错误修复需要细致的检查、分析和代码调整。掌握检测工具的使用、理解Schema.org规范以及熟悉各种错误类型是关键。定期监控和维护结构化数据，确保其准确性和有效性，最终提升网站的SEO效果。持续学习和实践，才能在结构化数据的优化道路上不断进步。

希望今天的分享对大家有所帮助！

结构化数据错误诊断与修复：一场代码层面的深度剖析

发表回复 取消回复

发表回复取消回复