WooCommerce: как собрать и очистить базу данных от зависших вариантов и вариантов с нулевым запасом

Диагностика проблемы зависших вариантов товаров в WooCommerce

Зависшие варианты товаров возникают, когда в базе данных остаются вариации с некорректным статусом, отсутствующим или нулевым запасом, которые не отображаются в каталоге, но занимают место и могут вызывать ошибки при обработке заказов. Это особенно актуально для магазинов с большим количеством вариаций, где из-за массовых импортов, кастомных скриптов или сбоев плагинов появляются «мертвые» варианты.

Чтобы проверить наличие таких вариантов, можно выполнить SQL-запрос к базе данных, фильтруя вариации с нулевым количеством и статусом publish:

SELECT p.ID, p.post_title, pm.meta_value AS stock_quantity
FROM wp_posts p
LEFT JOIN wp_postmeta pm ON p.ID = pm.post_id AND pm.meta_key = '_stock'
WHERE p.post_type = 'product_variation'
AND p.post_status = 'publish'
AND (pm.meta_value IS NULL OR pm.meta_value = '0');

Если запрос возвращает записи, это значит, что в магазине есть активные вариации без запаса, которые могут быть «зависшими».

Пошаговое решение: сбор и удаление зависших вариантов

1. Резервное копирование базы данных

Перед любыми операциями с базой данных обязательно сделайте бэкап через phpMyAdmin, Adminer или плагин (например, UpdraftPlus). Это позволит быстро откатить изменения при ошибках.

2. Создание скрипта для удаления вариантов с нулевым запасом

Реализуем удаление через WP CLI или PHP-функцию, которую можно добавить в functions.php активной темы или в отдельный плагин с безопасным вызовом.

function wc_remove_zero_stock_variations() {
    $args = [
        'post_type' => 'product_variation',
        'post_status' => 'publish',
        'meta_query' => [
            [
                'key' => '_stock',
                'value' => '0',
                'compare' => '=',
                'type' => 'NUMERIC'
            ]
        ],
        'posts_per_page' => -1,
        'fields' => 'ids',
    ];
    $query = new WP_Query($args);
    if (!empty($query->posts)) {
        foreach ($query->posts as $variation_id) {
            wp_delete_post($variation_id, true);
        }
    }
}
// Запуск функции один раз
add_action('init', function() {
    if (current_user_can('manage_woocommerce') && isset($_GET['clean_variations'])) {
        wc_remove_zero_stock_variations();
        wp_die('Зависшие варианты с нулевым запасом удалены');
    }
});

Для запуска скрипта нужно перейти по URL https://example.com/?clean_variations=1 с правами администратора WooCommerce.

3. Очистка метаданных и кэшей

После удаления вариаций стоит очистить кэш WooCommerce и transient-данные:

wc_delete_product_transients();
wp_cache_flush();

Это можно добавить в тот же скрипт или запустить вручную через WP CLI.

Проверка результата

Повторите SQL-запрос из раздела диагностики. Если он не возвращает записей, значит все варианты с нулевым запасом удалены. Также проверьте каталог товаров в админке и на фронте — отсутствуют ошибки и лишние вариации.

Частые ошибки и способы их исправления

• Удаление не тех вариаций — убедитесь, что фильтр по _stock = 0 корректен, а статусы выбраны правильно. Лучше сначала вывести ID и заголовки, проверить вручную.
• Проблема с правами доступа — скрипт запускается только для пользователей с manage_woocommerce. Если функция не срабатывает, проверьте права.
• Кэширование — после удаления вариаций WooCommerce может показывать устаревшие данные без очистки кэша.

Практические советы по безопасности и производительности

• Выполняйте удаление на тестовом стенде перед применением на рабочем сайте.
• Используйте транзакции, если работаете напрямую с базой данных через WP CLI, чтобы избежать частичного удаления.
• Регулярно чистите базу от устаревших данных с помощью планировщика задач WP Cron.

Сравнение вариантов очистки зависших вариаций