WooCommerce产品批量编辑自定义操作不生效问题求助

为WooCommerce产品后台列表的批量操作下拉菜单添加自定义「Sync Products」操作后，选项可正常显示，但选中产品点击应用按钮后，挂在handle_bulk_actions-edit-product过滤器上的回调始终不执行，回调内的echo测试代码无任何输出，功能无法正常运行。

• WooCommerce产品列表页没有完全沿用WordPress原生的批量操作处理逻辑：自3.5版本起，WooCommerce通过WC_Admin_List_Table_Products类重写了产品列表的批量处理流程，原生handle_bulk_actions-edit-product过滤器不会被稳定触发，这是回调不执行、echo无输出的根本原因。
• 即便钩子正常触发，在该回调中直接echo输出也无法显示：这个钩子的执行时机在HTTP重定向响应发送之前，所有输出都会被重定向逻辑清空，不会渲染到页面上。
• 后台通知的类名存在拼写错误：代码中写的is-dismissable是错误拼写，WordPress官方可关闭通知的正确类名是is-dismissible，拼写错误会导致通知的关闭按钮无法正常显示。

1. 增加兼容逻辑保证自定义批量操作的回调能被WooCommerce正常触发，同时保留原有钩子的逻辑结构
2. 移除回调中无效的echo输出，所有同步业务逻辑直接在回调中执行，处理结果通过重定向URL参数传递
3. 修正后台通知的类名拼写，增加基础权限校验和nonce校验避免未授权访问

修复后的完整可运行代码如下：

// 注册自定义批量操作选项到下拉菜单
add_filter('bulk_actions-edit-product', function($bulk_actions) {
    $bulk_actions['sync_products'] = __('Sync Products', 'txtdomain');
    return $bulk_actions;
});

// 自定义批量操作的核心处理逻辑
function wpmis_sync_bulk_product($redirect_url, $action, $post_ids) {
    if ($action !== 'sync_products') {
        return $redirect_url;
    }

    // 基础权限校验
    if (!current_user_can('edit_products')) {
        wp_die(__('You do not have permission to perform this action.', 'txtdomain'));
    }

    // 此处编写实际的产品同步逻辑
    $synced_count = 0;
    foreach ($post_ids as $post_id) {
        $post_id = intval($post_id);
        // 例如：调用同步接口、更新产品元数据、修改产品状态等
        // do_product_sync($post_id);
        $synced_count++;
    }

    // 将处理结果附加到重定向地址，用于后续显示通知
    $redirect_url = add_query_arg([
        'bulk_sync_done' => 1,
        'synced_count' => $synced_count
    ], $redirect_url);

    return $redirect_url;
}
// 挂载到原生钩子，兼容非WooCommerce改写的场景
add_filter('handle_bulk_actions-edit-product', 'wpmis_sync_bulk_product', 10, 3);

// 兼容WooCommerce改写产品列表批量逻辑的场景，确保操作能被正常触发
add_action('load-edit.php', function() {
    $screen = get_current_screen();
    if (!$screen || $screen->post_type !== 'product') {
        return;
    }

    // 校验批量操作请求
    $action = isset($_REQUEST['action']) ? sanitize_text_field($_REQUEST['action']) : '';
    if ($action === 'sync_products' && !empty($_REQUEST['post']) && is_array($_REQUEST['post'])) {
        $post_ids = array_map('intval', $_REQUEST['post']);
        check_admin_referer('bulk-posts');

        $redirect_url = admin_url('edit.php?post_type=product');
        $redirect_url = wpmis_sync_bulk_product($redirect_url, 'sync_products', $post_ids);
        
        wp_redirect($redirect_url);
        exit;
    }
});

// 显示批量操作完成后的后台通知
add_action('admin_notices', function() {
    if (empty($_REQUEST['bulk_sync_done']) || empty($_REQUEST['synced_count'])) {
        return;
    }
    $count = intval($_REQUEST['synced_count']);
    printf(
        '<div class="updated notice is-dismissible"><p>%s</p></div>',
        sprintf(__('Successfully synced %d products.', 'txtdomain'), $count)
    );
});

如果你的站点开启了WooCommerce HPOS高性能产品存储模式，还可以额外挂载handle_bulk_actions-edit-product_page_wc-admin--page--wc-products过滤器做兼容，保证新版产品管理页面下自定义批量操作也能正常运行。

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