开发WordPress插件时WooCommerce产品方法返回空值问题

可能的原因及对应解决方案 #

1. 先确认product_id的有效性 #

首先要确保从get_post_meta(get_the_ID(), 'product_id', true)拿到的product_id是正确的WooCommerce产品ID。可以临时加调试代码排查：

$product_id = get_post_meta(get_the_ID(), 'product_id', true);
// 临时输出到日志，确认ID是否正确
error_log('当前事件关联产品ID：' . $product_id);

如果product_id为空或不是有效产品ID，后续产品对象获取失败，库存字段自然为空。

2. 处理可变产品（Variable Product）的情况 #

如果关联产品是可变产品，父产品本身没有库存，库存数据存在于各个变体中，需要遍历变体统计：

if ($product_id && function_exists('wc_get_product')) 
{
    $product = wc_get_product($product_id);
    
    if ($product->is_type('variable')) {
        $total_stock = 0;
        $availability = 'outofstock'; // 默认缺货
        $variations = $product->get_available_variations();
        
        foreach ($variations as $variation) {
            $variation_product = wc_get_product($variation['variation_id']);
            $total_stock += $variation_product->get_stock_quantity() ?? 0;
            // 只要有一个变体有货，就标记为有货
            if ($variation_product->get_stock_status() === 'instock') {
                $availability = 'instock';
            }
        }
        $stock_quantity = $total_stock;
    } else {
        // 简单产品等类型直接获取库存
        $availability = $product->get_stock_status();
        $stock_quantity= $product->get_stock_quantity();
    }
}

3. 检查WooCommerce库存设置 #

确保后台已启用库存管理：

• 进入WordPress后台 → WooCommerce → 设置 → 产品 → 库存
• 勾选「启用库存管理」
• 确认目标产品的「管理库存」选项已开启（编辑产品时在「库存」面板设置）

4. 确保产品对象获取成功 #

即使product_id存在，也可能因产品被删除、状态未发布等原因导致wc_get_product返回false，需增加判断：

if ($product_id && function_exists('wc_get_product')) 
{
    $product = wc_get_product($product_id);
    
    if (!$product) {
        error_log('无法获取产品对象，ID：' . $product_id);
        $availability = 'invalid_product';
        $stock_quantity = 0;
    } else {
        // 这里处理库存逻辑
    }
}

5. 处理库存数量为null的情况 #

get_stock_quantity()在产品未启用库存或无库存时会返回null，可以统一处理为0：

$stock_quantity = $product->get_stock_quantity() ?? 0;

完整调整后的代码片段 #

while( $events->have_posts() ) {
    $events->the_post();
    $startDate = get_post_meta(get_the_ID(), apply_filters( 'piecal_start_date_meta_key', '_piecal_start_date' ) );
    $endDate = get_post_meta(get_the_ID(), apply_filters( 'piecal_end_date_meta_key', '_piecal_end_date' ) );
    $postType = get_post_type_object( get_post_type() );
    $allday = get_post_meta(get_the_ID(), '_piecal_is_allday') ? get_post_meta(get_the_ID(), '_piecal_is_allday', true) : "false";
    $acfFieldValue = get_field('kurscode', get_the_ID());
    $acfFieldValue2 = get_field('dauer', get_the_ID());
    $acfFieldValue3 = get_field('preis_pro_tag_pro_person', get_the_ID());
    $product_id = get_post_meta(get_the_ID(), 'product_id', true);
    $termine = get_field('termine', get_the_ID());
    $availability = '';
    $stock_quantity = 0; // 默认值设为0

    if ($product_id && function_exists('wc_get_product')) 
    {
        $product = wc_get_product($product_id);
        
        if ($product) {
            if ($product->is_type('variable')) {
                // 处理可变产品库存
                $total_stock = 0;
                $availability = 'outofstock';
                $variations = $product->get_available_variations();
                
                foreach ($variations as $variation) {
                    $variation_product = wc_get_product($variation['variation_id']);
                    if ($variation_product) {
                        $total_stock += $variation_product->get_stock_quantity() ?? 0;
                        if ($variation_product->get_stock_status() === 'instock') {
                            $availability = 'instock';
                        }
                    }
                }
                $stock_quantity = $total_stock;
            } else {
                // 处理简单产品等其他类型
                $availability = $product->get_stock_status();
                $stock_quantity = $product->get_stock_quantity() ?? 0;
            }
        } else {
            $availability = 'invalid_product';
            error_log('无效产品ID：' . $product_id);
        }
    }
    
    $dauer_text = ($acfFieldValue2 == 1) ? 'Tag' : 'Tagen';
    
    $event = [
        'image' => get_the_post_thumbnail(get_the_ID()),
        "title" => html_entity_decode(get_the_title()),
        "start" => $startDate[0],
        "end" => $endDate[0] ?? null,
        "details" => html_entity_decode(get_the_excerpt()),
        "permalink" => get_permalink(),
        "postType" => $postType->labels->singular_name ?? null,
        "kurscode" => $acfFieldValue,
        "dauer" => $acfFieldValue2 . ' ' . $dauer_text,
        "preis_pro_tag_pro_person" => $acfFieldValue3,
        'product_availability' => $availability,
        'stock' => $stock_quantity,
    ];
}

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