如何解决WooCommerce单产品页自定义tab中cross sells不展示的问题

woocommerce_cross_sell_display() 的原生设计定位是为购物车页面提供交叉推荐内容，它的默认数据获取逻辑是从全局购物车对象 WC()->cart 中，提取所有已加入购物车商品对应的交叉推荐集合，完全不会读取当前正在浏览的单产品自身配置的cross sell关联数据。
这也是为什么同实现逻辑下 woocommerce_upsell_display() 可以正常运行——upsell函数的数据源是直接绑定当前全局 $product 读取的，和cross sell的原生数据源逻辑存在本质区别。直接在单产品页调用该函数时，因为刚打开产品页还没有加购数据，购物车为空，函数会静默返回空内容，不会抛出任何PHP报错，和你遇到的“无报错、无视觉输出”的现象完全匹配。

要在单产品自定义tab中展示当前产品配置的cross sells，需要绕过原生函数的默认购物车取数逻辑，显式传入当前产品的cross sell ID集合，具体修改点如下：

• 在回调函数中先获取当前全局产品对象，调用 get_cross_sell_ids() 拿到该产品后台配置的交叉推荐商品ID列表
• 将获取到的ID数组作为参数传入 woocommerce_cross_sell_display()，覆盖函数默认的取数来源
• 补充空值判断，避免未配置cross sell的产品页出现冗余报错

修正后的可运行代码如下：

// 自定义tab注册逻辑（修正原代码的判断逻辑疏漏）
add_filter('woocommerce_product_tabs', 'add_new_default_product_tab' );
function add_new_default_product_tab( $tabs ) {
    global $product;
    // 调整评论tab的排序优先级
    if (isset($tabs['reviews'])) {
        $tabs['reviews']['priority'] = 20;
    }
    // 定义自定义tab的标题
    $custom_tab_title = "אביזרים";
    $custom_tab_title2 = "אביזרים משלימים";
    // 注册upsells展示tab
    if ( ! empty($custom_tab_title) ) {
        $tabs['awp-' . sanitize_title('props')] = array(
            'title' => $custom_tab_title,
            'callback' => 'awp_custom_woocommerce_tabs',
            'priority' => 5
        );
    }
    // 注册cross sells展示tab（修正原代码错误的判断条件）
    if ( ! empty($custom_tab_title2) ) {
        $tabs['awp-' . sanitize_title('additional-props')] = array(
            'title' => $custom_tab_title2,
            'callback' => 'awp_custom_woocommerce_tabs2',
            'priority' => 10
        );
    }
    return $tabs;
}

// 可正常运行的upsells回调
function awp_custom_woocommerce_tabs($key, $tab) {
    woocommerce_upsell_display( 3, 3 );
}

// 修正后可正常运行的cross sells回调
function awp_custom_woocommerce_tabs2($key, $tab) {
    global $product;
    // 非产品页场景直接终止
    if ( ! $product instanceof WC_Product ) return;
    
    // 获取当前产品配置的cross sell商品ID
    $cross_sell_ids = $product->get_cross_sell_ids();
    
    // 无配置时输出提示
    if ( empty($cross_sell_ids) ) {
        echo '<p>暂无配套推荐配件</p>';
        return;
    }
    
    // 显式传入cross sell ID集合，替代从购物车取数的默认逻辑
    woocommerce_cross_sell_display(
        limit: 3,
        columns: 3,
        orderby: 'rand',
        order: 'desc',
        cross_sells_ids: $cross_sell_ids
    );
}

• 代码部署后，需要先打开对应测试产品的编辑后台，在「链接产品」-「交叉销售」模块手动关联至少2个目标展示的商品，保存更新产品后再刷新前端tab页面，否则会因为无关联数据导致页面空白
• 如果使用的是3.0以下的旧版本WooCommerce，函数不支持命名参数传值，可以按顺序传入参数：

woocommerce_cross_sell_display( 3, 3, 'rand', 'desc', $cross_sell_ids );

• 若仍存在输出异常，可以直接用WooCommerce商品短代码兜底展示，兼容性更强：

echo do_shortcode( '[products ids="' . implode(',', $cross_sell_ids) . '" limit="3" columns="3"]' );

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