WooCommerce CSV导入产品后触发动作异常求助

核心问题分析 #

你遇到的问题大概率是通用save_post钩子与WooCommerce CSV导入流程不兼容，或者代码中存在未被捕获的错误、资源耗尽、循环触发等问题，导致第二个产品导入时进程中断。

排查与修复步骤 #

1. 替换通用钩子为WooCommerce导入专用钩子

WooCommerce CSV导入有专属的钩子，比save_post更适配批量导入场景，避免触发时机冲突：

// 针对新增/更新的导入产品触发逻辑
add_action('woocommerce_product_import_inserted_product_object', 'auto_handle_variable_product_on_import', 10, 2);
add_action('woocommerce_product_import_updated_product_object', 'auto_handle_variable_product_on_import', 10, 2);

function auto_handle_variable_product_on_import($product, $import_data) {
    // 仅处理可变产品
    if (!$product->is_type('variable')) {
        return $product;
    }

    // --- 你的属性添加、变体生成逻辑写在这里 ---
    // 示例：添加颜色属性
    $color_attr = array(
        'name' => '颜色',
        'value' => '红色,蓝色,绿色',
        'is_visible' => 1,
        'is_variation' => 1,
        'is_taxonomy' => 0
    );
    $product->update_meta_data('_product_attributes', array(
        'pa_color' => array(
            'name' => wc_clean($color_attr['name']),
            'value' => $color_attr['value'],
            'position' => 0,
            'is_visible' => $color_attr['is_visible'],
            'is_variation' => $color_attr['is_variation'],
            'is_taxonomy' => $color_attr['is_taxonomy']
        )
    ));

    // 示例：生成变体
    $variations = array(
        array('color' => '红色', 'price' => '29.99', 'stock' => 50),
        array('color' => '蓝色', 'price' => '29.99', 'stock' => 30),
        array('color' => '绿色', 'price' => '34.99', 'stock' => 20)
    );
    foreach ($variations as $var_data) {
        $variation = new WC_Product_Variation();
        $variation->set_parent_id($product->get_id());
        $variation->set_attributes(array('pa_color' => $var_data['color']));
        $variation->set_regular_price($var_data['price']);
        $variation->set_stock_quantity($var_data['stock']);
        $variation->save();
    }

    $product->save();
    return $product;
}

2. 排查代码中的循环触发问题

如果坚持使用save_post，必须避免循环触发（调用$product->save()会再次触发钩子）：

add_action('save_post_product', 'auto_add_variants_on_save', 10, 3);
function auto_add_variants_on_save($post_id, $post, $update) {
    // 临时移除钩子，防止循环触发
    remove_action('save_post_product', __FUNCTION__, 10);

    // 你的属性、变体生成逻辑...

    // 恢复钩子
    add_action('save_post_product', __FUNCTION__, 10, 3);
}

3. 排查资源耗尽问题

可变产品变体生成非常消耗内存，第一个产品处理后内存未释放会导致第二个产品导入失败：

• 在wp-config.php中提高内存限制：

  define('WP_MEMORY_LIMIT', '256M');
  define('WP_MAX_MEMORY_LIMIT', '512M');
  

• 临时提高PHP执行时间（仅测试用，生产环境谨慎）：

  set_time_limit(0);
  

4. 开启错误日志定位具体问题

开启WP调试模式捕获错误：
在wp-config.php中添加：

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

重新运行导入后，查看wp-content/debug.log和服务器PHP错误日志，定位具体的致命错误或警告。

5. 确认CSV导入的产品类型

确保CSV中每行的产品类型字段值为variable，避免代码逻辑因产品类型不匹配而跳过执行。

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