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

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

Дублирование артикулов (SKU) в WooCommerce приводит к ошибкам при управлении запасами, интеграции с внешними сервисами и аналитике. Первая задача — подтвердить, что дублирование действительно есть.

Как проверить наличие дубликатов SKU

• В админке WooCommerce перейдите в Товары > Все товары.
• Экспортируйте товары в CSV (через встроенный экспорт WooCommerce).
• Откройте CSV в Excel или Google Sheets и отсортируйте колонку SKU.
• Ищите повторяющиеся значения — это и есть дубликаты.

Можно также выполнить SQL-запрос напрямую в базе данных через phpMyAdmin или WP-CLI:

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

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

Причины появления дубликатов SKU

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

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

1. Создание резервной копии

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

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

Для массового исправления можно использовать следующий PHP-скрипт, запускаемый через WP-CLI или в файле темы с проверкой:

function fix_duplicate_skus() {
    global $wpdb;
    $duplicates = $wpdb->get_results(
        "SELECT meta_value AS sku, GROUP_CONCAT(post_id) AS ids, COUNT(*) AS count
        FROM {$wpdb->postmeta}
        WHERE meta_key = '_sku'
        GROUP BY sku
        HAVING count > 1"
    );
    foreach ($duplicates as $dup) {
        $ids = explode(',', $dup->ids);
        // Оставляем первый товар с оригинальным SKU, остальным добавляем суффиксы
        for ($i = 1; $i < count($ids); $i++) {
            $new_sku = $dup->sku . '-dup' . $i;
            update_post_meta($ids[$i], '_sku', $new_sku);
        }
    }
}
fix_duplicate_skus();

Этот код добавит суффиксы -dup1, -dup2 и так далее к повторяющимся SKU, делая их уникальными.

3. Добавление проверки уникальности при сохранении товара

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

add_action('woocommerce_admin_process_product_object', 'check_unique_sku_on_save', 10, 1);
function check_unique_sku_on_save($product) {
    $sku = $product->get_sku();
    if (empty($sku)) return;
    global $wpdb;
    $query = $wpdb->prepare(
        "SELECT post_id FROM {$wpdb->postmeta} WHERE meta_key = '_sku' AND meta_value = %s AND post_id != %d",
        $sku, $product->get_id()
    );
    $exists = $wpdb->get_var($query);
    if ($exists) {
        wp_die('Ошибка: SKU должен быть уникальным. Товар с таким SKU уже существует.');
    }
}

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

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

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

• Ошибка: Дублирование появляется снова после импорта.
  Решение: Перед импортом CSV добавьте проверку уникальности SKU, а лучше используйте плагины импорта с поддержкой валидации, например WP All Import с кастомными правилами.
• Ошибка: Сообщение об ошибке при сохранении SKU не отображается.
  Решение: Проверьте, что хук woocommerce_admin_process_product_object подключен и скрипт не конфликтует с другими плагинами.
• Ошибка: Суффиксы -dupX не подходят для бизнеса.
  Решение: Реализуйте более сложную логику генерации уникальных артикулов, например с использованием даты или уникального ID товара.

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

• Выполняйте массовые операции с SKU вне пиковых часов нагрузки сайта, чтобы избежать замедлений.
• Перед внесением изменений отключайте кэширование объектов (например, Redis) на время обработки, чтобы изменения сразу отражались.
• Используйте транзакции в базе данных, если выполняете сложные массовые исправления для предотвращения частичной записи.
• Добавьте мониторинг ошибок и логирование при сохранении SKU для быстрого выявления проблем.

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