如何在sitemap.xml中定义自定义元素？附XSD验证咨询

一、搜索引擎对自定义命名空间Sitemap的态度 #

XML命名空间确实支持扩展Sitemap的自定义字段，搜索引擎不会因为自定义标签拒绝整个文件，只会忽略它们不认识的内容。各主流搜索引擎的明确规则如下：

• Google：官方说明中提到，只要Sitemap的核心结构符合标准协议，额外的自定义标签会被直接忽略，不会影响文件的有效性。
• Bing：和Google立场一致，仅处理标准Sitemap字段，自定义内容不影响文件的提交与解析。
• 百度：官方文档明确指出，只要站点地图的核心部分符合《站点地图协议》，自定义标签不会导致文件被拒绝，只会被忽略。

二、你的代码问题、测试方法与XSD托管疑问 #

1. Sitemap.xml的修正点 #

你写的sitemap.xml里有个小问题：自定义标签用了saleor:category，但对应的XSD里定义的是category-id，标签名不匹配会导致XSD验证失败。修正后的代码如下：

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns:saleor="http://example.org/xml-schemas/saleor-ref.xsd"
    xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
    <url>
        <loc>https://example.org/cat/product</loc>
        <lastmod>2020-02-17</lastmod>
        <saleor:ref>
            <saleor:id>coolsaleoridofaproduct</saleor:id>
            <saleor:category-id>coolidoftheparentcategory</saleor:category-id>
        </saleor:ref>
    </url>
    <url>
        <loc>http://example.org/cat</loc>
        <lastmod>2021-02-17</lastmod>
        <saleor:ref>
            <saleor:id>coolsaleoridofaproduct</saleor:id>
        </saleor:ref>
    </url>
</urlset>

2. saleor-ref.xsd的优化 #

你的XSD定义大体正确，但可以做两点优化让验证更严谨：

• 添加命名空间前缀声明，确保自定义元素被正确限定
• 设置elementFormDefault="qualified"，强制命名空间下的元素必须带前缀

优化后的XSD代码：

<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" 
           targetNamespace="http://example.org/xml-schemas/saleor-ref.xsd"
           xmlns:saleor="http://example.org/xml-schemas/saleor-ref.xsd"
           elementFormDefault="qualified">
  <xs:element name="ref">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="id" type="xs:string"/>
        <xs:element name="category-id" type="xs:string" minOccurs="0"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

3. XSD是否必须托管在targetNamespace的URL？ #

不需要。targetNamespace只是一个用来区分不同命名空间的唯一标识符，不一定对应可访问的真实URL。如果需要让XML解析器自动验证Sitemap的结构，可以在sitemap.xml中通过xsi:schemaLocation指定XSD的位置（本地路径或任意可访问的URL都可以），比如：

<urlset xmlns:saleor="http://example.org/xml-schemas/saleor-ref.xsd"
        xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9 http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd
                            http://example.org/xml-schemas/saleor-ref.xsd /your/local/path/saleor-ref.xsd">

如果不需要自动验证，仅作为内部文档规范，完全不用托管XSD，只要保持命名空间URI唯一就行。

4. 测试方法 #

• 语法检查：用在线XML验证工具检查sitemap.xml的基本语法，确保没有闭合错误、编码问题。
• XSD验证：使用支持XSD验证的工具（比如VS Code的XML插件、XMLSpy，或者在线XML+XSD验证工具），验证修改后的Sitemap是否符合自定义XSD的约束。
• 搜索引擎测试：将修正后的Sitemap提交到Google Search Console或Bing Webmaster Tools，查看平台是否标记为“有效”——只要标准字段符合要求，即使有自定义标签，也会通过验证。

内容的提问来源于stack exchange，提问作者djkato