WooCommerce: как исправить ошибку дублирующихся SKU товаров

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

Ошибка дублирующихся SKU возникает, когда два или более товара в WooCommerce имеют одинаковый уникальный идентификатор SKU. Это приводит к проблемам в учёте запасов, интеграции с внешними системами и может вызвать сбои в плагинах аналитики или синхронизации.

Чтобы проверить наличие дублей, выполните SQL-запрос напрямую в базе данных WordPress (используя phpMyAdmin или другой инструмент):

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

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

Почему дублируются SKU и как это исправить

Причины дублирования

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

Пошаговое решение проблемы

1. Резервная копия базы данных: перед любыми изменениями сделайте полную резервную копию базы данных.
2. Поиск дублирующихся SKU: используйте SQL-запрос выше для выявления дублей.
3. Автоматическое исправление дублей: можно написать PHP-скрипт, который добавит суффикс к дублирующимся SKU:

function fix_duplicate_skus() {
    global $wpdb;
    $duplicates = $wpdb->get_results(
        "SELECT meta_value FROM {$wpdb->postmeta} WHERE meta_key = '_sku' GROUP BY meta_value HAVING COUNT(*) > 1"
    );

    foreach ($duplicates as $dup) {
        $sku = $dup->meta_value;
        $posts = $wpdb->get_results($wpdb->prepare(
            "SELECT post_id FROM {$wpdb->postmeta} WHERE meta_key = '_sku' AND meta_value = %s",
            $sku
        ));

        $counter = 1;
        foreach ($posts as $post) {
            if ($counter == 1) {
                $counter++;
                continue; // сохраняем первый товар с оригинальным SKU
            }
            $new_sku = $sku . '-' . $counter;
            update_post_meta($post->post_id, '_sku', $new_sku);
            $counter++;
        }
    }
}
add_action('init', 'fix_duplicate_skus');

Этот код при инициализации сайта добавит к дублирующимся SKU суффиксы -1, -2 и т.д.

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

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

Частые ошибки при исправлении дублирующихся SKU и их решение

• Не сделана резервная копия базы данных — любые ошибки необратимы; всегда делайте бэкап.
• Использование неуникальных суффиксов — скрипт добавляет числовые суффиксы, избегайте повторных попыток с теми же значениями.
• Обновление SKU без обновления связанных данных — если есть интеграции, убедитесь, что они учитывают изменённые SKU.
• Запуск скрипта несколько раз — добавляет лишние суффиксы, отключайте скрипт после выполнения.

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

• Не храните SKU как обычное метаполе без проверки уникальности — используйте хук woocommerce_product_set_sku для валидации при сохранении товара.
• Оптимизируйте базу данных, удаляя неиспользуемые метаполя, чтобы ускорить запросы по SKU.
• При большом количестве товаров используйте индекс по метаполю _sku для ускорения запросов:

ALTER TABLE wp_postmeta ADD INDEX sku_index (meta_key(20), meta_value(100));

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