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

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

Дублирование артикулов (SKU) в WooCommerce вызывает серьезные проблемы с управлением товаром, интеграциями с 1С, внешними маркетплейсами и аналитикой. Чтобы понять масштаб проблемы, выполните следующие шаги:

• Перейдите в админку WordPress → Товары → Все товары.
• Включите столбец SKU в списке товаров, если он не отображается.
• Отсортируйте товары по артикулу и внимательно проверьте наличие одинаковых значений.
• При большом каталоге удобнее выполнить SQL-запрос через phpMyAdmin или WP-CLI:

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

Этот запрос покажет все SKU, которые встречаются более одного раза.

Основные причины дублирования SKU в WooCommerce

• Импорт товаров без проверки уникальности артикулов.
• Создание вариаций с одинаковым SKU как у родительского товара или других вариаций.
• Плагины для импорта или синхронизации с внешними системами, которые не проверяют дубликаты.
• Ручное дублирование товаров с копированием SKU.

Пошаговое решение проблемы дублирования SKU

1. Резервное копирование

Перед любыми изменениями обязательно создайте бэкап базы данных и файлов сайта.

2. Поиск и исправление дубликатов вручную

Если дубликатов немного, исправьте SKU вручную через админку WooCommerce:

• Откройте товар с дублирующимся SKU.
• Измените артикул на уникальный (например, добавив суффикс).
• Сохраните изменения.

3. Автоматическая проверка и исправление через WP-CLI

Для больших каталогов удобно использовать WP-CLI и PHP-скрипт, который проверит и исправит дубликаты, добавляя суффиксы:

<?php
// wp-cli command to fix duplicate SKUs
function fix_duplicate_skus() {
    global $wpdb;

    $skus = $wpdb->get_col("SELECT meta_value FROM {$wpdb->postmeta} WHERE meta_key = '_sku'");
    $seen = [];

    foreach ($skus as $sku) {
        if (empty($sku)) continue;
        if (in_array($sku, $seen)) {
            $count = 1;
            $new_sku = $sku . '-' . $count;
            while (in_array($new_sku, $seen)) {
                $count++;
                $new_sku = $sku . '-' . $count;
            }
            // Обновить все записи с этим SKU
            $wpdb->query($wpdb->prepare(
                "UPDATE {$wpdb->postmeta} SET meta_value = %s WHERE meta_key = '_sku' AND meta_value = %s",
                $new_sku, $sku
            ));
            $seen[] = $new_sku;
        } else {
            $seen[] = $sku;
        }
    }
    WP_CLI::success('Дубликаты SKU исправлены.');
}

if (defined('WP_CLI') && WP_CLI) {
    WP_CLI::add_command('fix-duplicate-skus', 'fix_duplicate_skus');
}
?>

Запустите команду в терминале:

wp fix-duplicate-skus

4. Валидация уникальности при импорте и редактировании

Чтобы предотвратить повторное появление дубликатов, добавьте проверку уникальности SKU в функции темы или плагина:

add_action('save_post_product', 'check_unique_sku', 10, 3);
function check_unique_sku($post_id, $post, $update) {
    if ($post->post_type !== 'product') return;

    $sku = get_post_meta($post_id, '_sku', true);
    if (empty($sku)) return;

    global $wpdb;
    $existing = $wpdb->get_var($wpdb->prepare(
        "SELECT post_id FROM {$wpdb->postmeta} WHERE meta_key = '_sku' AND meta_value = %s AND post_id != %d",
        $sku, $post_id
    ));

    if ($existing) {
        wp_die('Ошибка: SKU должен быть уникальным. Товар с таким артикулом уже существует.');
    }
}

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

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

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

• Ошибка: Плагины импорта не проверяют уникальность SKU.
  Решение: Используйте проверенный плагин с поддержкой валидации или кастомную проверку через хуки.
• Ошибка: Вариации товара имеют одинаковый SKU с родительским товаром.
  Решение: Обеспечьте уникальность SKU для каждой вариации, добавляя суффиксы или префиксы.
• Ошибка: Ручное копирование товаров с сохранением прежних артикулов.
  Решение: Перед публикацией проверяйте уникальность SKU, используйте хук save_post_product для блокировки сохранения.
• Ошибка: Незнание, что пустой SKU считается уникальным.
  Решение: Рекомендуется всегда указывать SKU. Можно добавить проверку на пустоту.

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

• Используйте транзакции или batch-обновления при массовом исправлении SKU, чтобы избежать ошибок в базе.
• Добавьте уникальный индекс в базу данных для поля _sku, если объем товаров большой, чтобы ускорить поиск и избежать дубликатов на уровне БД:

ALTER TABLE wp_postmeta ADD UNIQUE INDEX unique_sku (meta_key(191), meta_value(191)) WHERE meta_key = '_sku';

Обратите внимание, что эта команда может потребовать адаптации под вашу версию MySQL и структуру таблицы. Делайте бэкап перед изменениями.

• Регулярно проводите аудит SKU с помощью автоматических скриптов или плагинов для предотвращения накопления дубликатов.
• Если используете WooCommerce с внешними системами (CRM, ERP), настройте двустороннюю синхронизацию с проверкой уникальности SKU.

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