Google富结果测试工具无法识别.NET Core项目插入的JSON-LD是什么原因

问题原因及解决方案 #

• 核心原因：你当前使用的WebSite类型Schema本身没有对应基础富结果样式，Google仅对配置了potentialAction（类型为SearchAction）字段的WebSite结构化数据，提供站点搜索框的富结果展示。你现有JSON-LD仅包含name、alternateName、url三个基础字段，未达到Google富结果的必填属性要求，因此会提示无可用富内容。
• 其他可排查点：
  • 验证实际输出的JSON-LD格式合法性：虽然你排除了Schema.NET库的问题，仍需确认@Html.Raw输出的内容没有多余转义字符、HTML残留，可直接复制页面实际输出的压缩JSON到JSON校验工具确认格式无错。
  • 排查页面是否存在其他冲突的结构化数据：如果页面同时存在其他语法错误、或者重复类型的JSON-LD/Microdata片段，可能导致Google解析器跳过你的有效WebSite片段。
  • 确认工具测试逻辑：如果你的站点是新站或者权重较低，可能会出现工具检测到结构但实际搜索时不展示富结果的情况，但这种情况不会在测试工具里直接报“不存在富内容”，因此优先排查字段缺失问题。

修复示例（实现站点搜索框富结果） #

如果需要获取WebSite对应的站点搜索框富结果，你可以调整C#代码补充potentialAction字段：

@{
    var website = new WebSite()
    {
        AlternateName = "example.com - My favourite website",
        Name = "example.com",
        Url = new Uri("https://example.com"),
        PotentialAction = new SearchAction()
        {
            Target = new Uri("https://example.com/search?q={search_term_string}"),
            QueryInput = "required name=search_term_string"
        }
    };
    var jsonLd = website.ToString();
}
<script type="application/ld+json">
@* 仅可传入可信内容，禁止传入用户输入避免XSS风险 *@
    @Html.Raw(jsonLd)
</script>

修改后重新提交到Google富结果测试工具，即可识别到对应的站点搜索框富内容。

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