WooCommerce数据迁移至新主机后产品异常及批量修复需求

问题背景 #

站点迁移至新主机后，WooCommerce出现产品数据库关联故障：仅手动打开单个产品点击「更新」（无需修改内容）可修复，但批量编辑保存无效，尝试的自动更新脚本未生效。原脚本如下：

add_action( 'woocommerce_loaded', 'update_products_by_x' );
function update_products_by_x(){
    $limit = 200;

    // getting all products
    $products_ids = get_posts( array(
        'post_type'        => 'product','product_variation',
        'numberposts'      => $limit,
        'post_status'      => 'publish',
        'fields'           => 'ids',
        'meta_query'       => array( array(
            'key'     => '_sync_updated',
            'compare' => 'NOT EXISTS',
        ) )
    ) );

    // Loop through product Ids
    foreach ( $products_ids as $product_id ) {

        // Get the WC_Product object
        $product = wc_get_product($product_id);

        // Mark product as updated
        $product->update_meta_data( '_sync_updated', true );

        $product->save();
    }
}

已排查的字段差异 #

导出产品CSV后发现，修复与未修复产品的Meta字段存在明显差异：

• _a3_pvc_activated：已修复值为FALSE，未修复为空
• _monsterinsights_sitenote_active：已修复值为0，未修复为空
• _wpas_skip_publicize_24800780：已修复值为1，未修复为空
• _wpas_skip_publicize_25101066：已修复值为1，未修复为空

搜索异常表现 #

访问带空s=参数的分类链接（如?product_cat=1-circulated&s=&post_type=product）仅显示4个产品，但右侧分类统计显示有12个；移除s=参数后可显示全部12个，说明分类关联正常但搜索查询逻辑异常。

1. 修复脚本的问题修正 #

原脚本存在两个关键问题：post_type参数格式错误（应使用数组而非字符串拼接），且未触发完整的产品更新逻辑。修正后的脚本如下：

add_action( 'admin_init', 'bulk_fix_migrated_products' );
function bulk_fix_migrated_products() {
    // 仅管理员可执行，避免误触发
    if ( ! current_user_can( 'manage_options' ) ) return;

    // 限制单次处理数量，防止超时
    $limit = 50;

    // 获取未修复的产品ID
    $product_ids = get_posts( array(
        'post_type'      => array( 'product', 'product_variation' ),
        'numberposts'    => $limit,
        'post_status'    => 'publish',
        'fields'         => 'ids',
        'meta_query'     => array(
            array(
                'key'     => '_migrated_fixed',
                'compare' => 'NOT EXISTS'
            )
        )
    ) );

    foreach ( $product_ids as $product_id ) {
        $product = wc_get_product( $product_id );
        if ( ! $product ) continue;

        // 手动补全缺失的Meta字段
        $product->update_meta_data( '_a3_pvc_activated', 'FALSE' );
        $product->update_meta_data( '_monsterinsights_sitenote_active', '0' );
        $product->update_meta_data( '_wpas_skip_publicize_24800780', '1' );
        $product->update_meta_data( '_wpas_skip_publicize_25101066', '1' );

        // 标记为已修复
        $product->update_meta_data( '_migrated_fixed', true );

        // 保存产品并触发完整更新逻辑
        $product->save();

        // 同步更新post修改时间，确保数据库关联同步
        wp_update_post( array(
            'ID' => $product_id,
            'post_modified' => current_time( 'mysql' ),
            'post_modified_gmt' => current_time( 'mysql', 1 )
        ) );
    }

    // 若仍有未处理产品，自动刷新页面继续处理
    if ( count( $product_ids ) === $limit ) {
        wp_safe_redirect( $_SERVER['REQUEST_URI'] );
        exit;
    }
}

使用说明：

• 将代码添加至主题functions.php或自定义插件中
• 登录后台后，脚本会自动分批处理未修复产品，完成后删除代码避免重复执行

2. 搜索异常修复方法 #

空s=参数触发了WooCommerce搜索过滤，但未修复产品的索引字段缺失导致不被匹配，可通过以下两种方式解决：

• 重建产品索引：后台进入「WooCommerce > 状态 > 工具」，找到「产品查找数据库」，点击「重建」
• 修改搜索查询逻辑：添加以下代码至functions.php：

add_filter( 'woocommerce_product_query', 'fix_empty_search_query' );
function fix_empty_search_query( $query ) {
    if ( is_admin() ) return $query;

    // 当搜索参数为空时，移除搜索过滤
    if ( isset( $_GET['s'] ) && empty( $_GET['s'] ) ) {
        $query->set( 's', '' );
        $query->is_search = false;
    }

    return $query;
}

3. 数据库层面直接修复（可选） #

若脚本执行缓慢，可通过SQL批量插入缺失的Meta字段（执行前务必备份数据库，替换wp_为你的表前缀）：

-- 插入_a3_pvc_activated字段
INSERT INTO wp_postmeta (post_id, meta_key, meta_value)
SELECT ID, '_a3_pvc_activated', 'FALSE'
FROM wp_posts
WHERE post_type IN ('product', 'product_variation')
AND post_status = 'publish'
AND ID NOT IN (SELECT post_id FROM wp_postmeta WHERE meta_key = '_a3_pvc_activated');

-- 插入monsterinsights字段
INSERT INTO wp_postmeta (post_id, meta_key, meta_value)
SELECT ID, '_monsterinsights_sitenote_active', '0'
FROM wp_posts
WHERE post_type IN ('product', 'product_variation')
AND post_status = 'publish'
AND ID NOT IN (SELECT post_id FROM wp_postmeta WHERE meta_key = '_monsterinsights_sitenote_active');

-- 插入wpas_skip_publicize字段
INSERT INTO wp_postmeta (post_id, meta_key, meta_value)
SELECT ID, '_wpas_skip_publicize_24800780', '1'
FROM wp_posts
WHERE post_type IN ('product', 'product_variation')
AND post_status = 'publish'
AND ID NOT IN (SELECT post_id FROM wp_postmeta WHERE meta_key = '_wpas_skip_publicize_24800780');

INSERT INTO wp_postmeta (post_id, meta_key, meta_value)
SELECT ID, '_wpas_skip_publicize_25101066', '1'
FROM wp_posts
WHERE post_type IN ('product', 'product_variation')
AND post_status = 'publish'
AND ID NOT IN (SELECT post_id FROM wp_postmeta WHERE meta_key = '_wpas_skip_publicize_25101066');

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