Как исправить дублирование SKU в WooCommerce: диагностика и практические решения

Диагностика проблемы с дублирующимися SKU в WooCommerce

Дублирование артикулов (SKU) в WooCommerce вызывает ошибки при учёте товаров, инвентаризации и интеграции с внешними сервисами. Часто это проявляется как:

• ошибки при сохранении товара с уже существующим SKU;
• конфликты в экспорте и импорте товаров;
• неправильное отображение товара в корзине и заказах;
• проблемы с интеграциями 1С, CRM и складскими программами.

Для начала нужно проверить, действительно ли есть дублирующиеся SKU. Для этого можно воспользоваться SQL-запросом к базе данных:

SELECT meta_value AS sku, COUNT(*) AS count FROM wp_postmeta WHERE meta_key = '_sku' GROUP BY meta_value HAVING count > 1;

Если запрос возвращает строки, значит, в базе есть товары с одинаковым SKU.

Проверка дубликатов через админку WooCommerce

В стандартной админке WooCommerce нет фильтрации по дублирующимся SKU. Можно экспортировать товары в CSV и проверить столбец SKU через Excel или Google Sheets, используя условное форматирование для поиска повторов.

Как исправить дублирование SKU: пошаговое решение

1. Сделать резервную копию сайта и базы данных

Перед изменениями обязательно сохраняйте полный бэкап, чтобы избежать потери данных.

2. Локализовать все дубликаты SKU

Используйте SQL-запрос выше или экспортируйте товары в CSV и найдите повторы.

3. Исправить дублирующиеся SKU программно

Если товаров много, вручную менять неудобно. Ниже пример кода для автоматической смены дублирующихся SKU, добавляя суффикс:

function fix_duplicate_skus() {
    global $wpdb;
    $skus = $wpdb->get_results("SELECT post_id, meta_value FROM {$wpdb->postmeta} WHERE meta_key = '_sku'");
    $seen = [];
    foreach ($skus as $sku) {
        if (empty($sku->meta_value)) continue;
        if (isset($seen[$sku->meta_value])) {
            $new_sku = $sku->meta_value . '-' . $sku->post_id;
            update_post_meta($sku->post_id, '_sku', $new_sku);
        } else {
            $seen[$sku->meta_value] = true;
        }
    }
}
add_action('init', 'fix_duplicate_skus');

Этот код проверяет все SKU и если находит повтор, дописывает к нему ID товара для уникальности.

4. Включить проверку уникальности SKU при сохранении товара

Чтобы в будущем избежать повторов, можно добавить проверку при сохранении товара:

add_action('woocommerce_admin_process_product_object', 'validate_unique_sku', 10, 1);
function validate_unique_sku($product) {
    $sku = $product->get_sku();
    if (!$sku) return;

    $args = [
        'post_type' => 'product',
        'post_status' => 'publish',
        'posts_per_page' => -1,
        'meta_query' => [
            [
                'key' => '_sku',
                'value' => $sku,
                'compare' => '=',
            ],
        ],
        'fields' => 'ids',
    ];
    $query = new WP_Query($args);
    foreach ($query->posts as $post_id) {
        if ($post_id != $product->get_id()) {
            wc_add_notice(__('SKU должен быть уникальным. Такой SKU уже используется.'), 'error');
            break;
        }
    }
}

Проверка результата после исправления дублирования SKU

После внесения изменений:

• Запустите SQL-запрос на поиск дублей SKU. Результат должен быть пустой.
• Попробуйте создать/обновить товар с существующим SKU — должно появляться сообщение об ошибке.
• Проверьте работу внешних интеграций и отчётов, чтобы убедиться в отсутствии конфликтов.

Частые ошибки и как их исправить

• Ошибка: Изменения не применяются сразу.
  Причина: Кеширование метаданных или объектов товаров.
  Решение: Очистите кеш WooCommerce и кеш на сервере.
• Ошибка: Сообщение об ошибке не отображается при сохранении товара.
  Причина: Не подключен правильный хук или код находится вне области админки.
  Решение: Добавьте проверку is_admin() и используйте хуки WooCommerce для админки.
• Ошибка: Дублирование SKU появляется после импорта товаров.
  Причина: Импорт не проверяет уникальность SKU.
  Решение: Используйте плагины импорта с поддержкой проверки уникальности SKU либо предварительно очистите дубликаты.

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

• Регулярно проверяйте уникальность SKU — это предотвращает ошибки учёта и интеграций.
• Избегайте прямых SQL-запросов в продакшн без кеширования — используйте WP_Query и методы WC_Product.
• При большом количестве товаров используйте фоновые задачи (WP-CLI или WP Cron) для исправления дублей, чтобы не нагружать сервер.
• Для улучшения производительности используйте индексы в базе данных по метаполям '_sku'.

Сравнение способов решения дублирования SKU