WooCommerce产品动态Schema标记代码运行异常求助

我帮你排查这个问题，你的代码里确实有几个关键细节没处理好，导致JSON输出被截断，尤其是PHP与HTML混合编写时的转义和产品对象获取问题：

问题分析 #

1. 产品对象获取不可靠：直接用global $product在部分场景下可能无法正确拿到产品对象（比如某些主题或插件修改了查询上下文），后续调用$product->get_name()等方法可能返回空或报错，打断JSON输出。
2. 未做JSON转义处理：产品名称、描述、品牌等字段如果包含引号、换行或特殊字符，直接输出会破坏JSON的语法结构，导致浏览器解析时提前终止脚本，只显示部分内容。
3. Schema结构不规范：review字段在Schema规范中应该是数组类型，你当前的写法是单个对象，可能导致解析异常。

修正后的完整代码 #

add_action('wp_head', 'schema_product');
function schema_product(){
    // 仅在产品单页执行
    if (!is_singular('product')) return;

    // 可靠获取产品对象
    $product_id = get_the_ID();
    $product = wc_get_product($product_id);
    if (!$product) return;

    // 准备Schema数据，提前处理所有字段
    $schema_data = array(
        "@context" => "http://schema.org",
        "@type" => "Product",
        "name" => $product->get_name(),
        "description" => "Ver descripción en el link incluido.",
        "image" => get_the_post_thumbnail_url($product_id, 'full'),
        "url" => get_permalink($product_id),
        "sku" => $product->get_sku(),
        "brand" => get_post_meta($product_id, 'brand', true),
        "offers" => array(
            "@type" => "Offer",
            "availability" => "http://schema.org/" . ($product->is_in_stock() ? 'InStock' : 'OutOfStock'),
            "price" => $product->get_price(),
            "priceValidUntil" => "2024-12-31", // 建议更新为有效日期或动态生成
            "priceCurrency" => get_woocommerce_currency(),
            "url" => get_permalink($product_id)
        ),
        "aggregateRating" => array(
            "@type" => "AggregateRating",
            "bestRating" => "5",
            "ratingValue" => "5",
            "reviewCount" => "3"
        ),
        "review" => array( // 修改为数组格式符合Schema规范
            array(
                "@type" => "Review", // 补充Review类型
                "author" => "Federico",
                "reviewRating" => array(
                    "@type" => "Rating",
                    "bestRating" => "5",
                    "ratingValue" => "5",
                    "worstRating" => "1" // 修正为合理的最低评分
                )
            )
        )
    );

    // 输出转义后的完整JSON
    echo '<script type="application/ld+json">' . wp_json_encode($schema_data) . '</script>';
};

关键修改说明 #

• 可靠获取产品对象：用wc_get_product($product_id)代替global $product，确保在任何产品页都能拿到有效的产品实例，避免空对象报错。
• 统一JSON转义：使用wp_json_encode()处理整个数组，自动转义所有特殊字符（引号、换行等），彻底避免JSON语法错误导致的输出截断。
• 规范Schema结构：把review改为数组格式，并补充@type" => "Review"，符合Schema.org的官方规范，减少解析异常。
• 提前终止逻辑：在非产品页或获取不到产品对象时直接返回，避免无效代码执行。

测试方法 #

刷新产品页面后，右键查看页面源代码，找到<script type="application/ld+json">标签，检查JSON内容是否完整，也可以用JSON校验工具粘贴内容验证语法是否正确。

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