WooCommerce批量更新所有商品指定自定义字段失败排查

核心错误点 #

• update_post_meta参数错误：该函数第一个参数要求传入帖子ID，你当前传入的是产品对象$product，这是导致更新完全失效的核心原因。
• 重复获取产品对象：代码中已通过$product_att = wc_get_product($post->ID)获取产品对象，后续重复获取$product = wc_get_product($post->ID)属于冗余操作。
• 缺少错误防护逻辑：
  • 若custom_field_options_unit()返回的数组不存在$unit_to_use对应的键，会触发PHP警告并中断整个循环
  • 当$amount_to_use为空、非数值或等于0时，会触发除以0的致命错误，直接终止函数执行
• 钩子时机不合理：init钩子执行时WooCommerce可能尚未完全初始化，导致部分产品功能无法正常调用。

修复后的完整代码 #

function update_my_metadata(){
    // 限制仅后台管理员可触发，避免前端重复执行
    if ( ! is_admin() || ! current_user_can('manage_options') ) {
        return;
    }

    $args = array(
        'post_type'      => 'product', 
        'post_status'    => 'publish', 
        'posts_per_page' => -1,
        'fields'         => 'ids' // 仅获取产品ID，降低内存占用
    );
    $product_ids = get_posts($args);

    foreach ( $product_ids as $product_id ) {
        $product = wc_get_product( $product_id );
        if ( ! $product ) {
            continue; // 跳过无效产品
        }

        $price_to_use = $product->get_price();
        if ( empty($price_to_use) || ! is_numeric($price_to_use) ) {
            continue; // 跳过无有效价格的产品
        }

        $unit_to_use = $product->get_meta( 'custom_text_field_unit' );
        $unit_options = custom_field_options_unit();
        // 检查单位选项是否存在对应键
        if ( ! isset($unit_options[$unit_to_use]) ) {
            continue;
        }
        $unit_touse_esc = $unit_options[$unit_to_use];

        $currency = get_woocommerce_currency_symbol();

        $amount_to_use = $product->get_meta( 'rasa_store_product_ppu_number' );
        // 避免除以0或非数值的情况
        if ( empty($amount_to_use) || ! is_numeric($amount_to_use) || $amount_to_use == 0 ) {
            continue;
        }

        $calculation = round( $price_to_use / $amount_to_use, 2 );
        $english_format_number = number_format($calculation, 2, '.', '');
        $rasa_price_per_unit_spanish_club = $english_format_number . ' ' . $currency . $unit_touse_esc ;

        // 传入产品ID作为update_post_meta的第一个参数
        update_post_meta( $product_id, 'price_per_kg', $rasa_price_per_unit_spanish_club );
    }
}
// 改用wp_loaded钩子，确保WooCommerce完全加载后执行
add_action('wp_loaded','update_my_metadata');

额外优化建议 #

• 添加触发开关：可以通过查询参数控制执行，比如仅当后台地址带有?update_ppu=1时才运行函数，避免每次刷新后台都执行批量更新
• 分批处理产品：如果店铺产品数量较多，posts_per_page=-1可能导致内存溢出，建议用paged参数分批循环获取产品ID
• 调试排查：在关键逻辑处添加error_log()输出变量值，比如error_log('产品'.$product_id.'的计算值：'.$rasa_price_per_unit_spanish_club);，通过服务器日志定位问题

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