Shopware 6中Google Search Console报面包屑itemListElement缺少item问题

当Shopware 6导航中使用无页面分类（未关联CMS页面或商品列表的分类）时，面包屑里的该分类项默认不会生成链接，这会导致Google Search Console（GSC）报错，提示面包屑的itemListElement中缺少item属性——因为Schema.org的BreadcrumbList要求每个列表项必须包含对应URL的item字段。

以下是两种可行的解决方法：

方法1：修改模板强制生成链接 #

通过自定义模板，为无页面分类补全面包屑的链接和结构化数据：

1. 找到Shopware默认面包屑模板路径：src/Storefront/Resources/views/storefront/layout/breadcrumb.html.twig
2. 修改面包屑列表渲染逻辑，即使分类无关联页面，也生成指向分类路由的链接：

{% for item in breadcrumbItems %}
    {% set isLastLoop = loop.last %}
    <li class="breadcrumb-item{% if isLastLoop %} active{% endif %}">
        {% if not isLastLoop %}
            {% if item.type == 'category' and not item.url %}
                <a href="{{ path('frontend.navigation.page', { navigationId: item.id }) }}">{{ item.name }}</a>
            {% else %}
                <a href="{{ item.url }}">{{ item.name }}</a>
            {% endif %}
        {% else %}
            <span>{{ item.name }}</span>
        {% endif %}
    </li>
{% endfor %}

3. 同步更新页面底部的结构化数据脚本，确保每个ListItem都有item属性：

<script type="application/ld+json">
{
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "itemListElement": [
        {% for item in breadcrumbItems %}
        {
            "@type": "ListItem",
            "position": {{ loop.index }},
            "name": "{{ item.name|escape('json') }}",
            "item": "{{ item.url ?: path('frontend.navigation.page', { navigationId: item.id }) }}"
        }{% if not loop.last %},{% endif %}
        {% endfor %}
    ]
}
</script>

注意：建议通过自定义插件覆盖模板，避免Shopware版本更新时丢失修改；如果使用第三方主题，需修改主题对应的面包屑模板文件。

方法2：为无页面分类关联空白CMS页面 #

无需修改代码，通过后台配置解决：

• 进入Shopware后台，创建一个空白CMS页面（仅保留基础布局，无需添加内容）
• 找到目标无页面分类，在「CMS页面」选项中选择刚创建的空白页面并保存
• 保存后，该分类会自动生成合法URL，面包屑的链接和结构化数据都会正常生成，GSC的报错会自动消失

验证修改 #

完成上述任一方法后，在Google Search Console中重新提交面包屑结构化数据进行验证，确认报错已修复。

内容的提问来源于stack exchange，提问作者Paweł Napierała