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

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

Дублирование артикулов (SKU) в WooCommerce приводит к путанице в управлении складом, ошибкам при заказах и сбоям в интеграции с внешними сервисами. Обычно проблема проявляется при импорте товаров, дублировании продуктов или ошибках в коде, добавляющем товары программно.

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

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

Если запрос возвращает строки, значит, в базе есть повторяющиеся артикулы. Это и есть источник проблемы.

Почему WooCommerce требует уникальные SKU

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

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

1. Найдите все дублирующиеся SKU

Для удобства можно использовать PHP-скрипт с WP_Query, который выведет все дубли:

$args = [
    'post_type' => 'product',
    'posts_per_page' => -1,
    'meta_query' => [
        [
            'key' => '_sku',
            'compare' => 'EXISTS',
        ],
    ],
];
$query = new WP_Query($args);

$sku_counts = [];

while ($query->have_posts()) {
    $query->the_post();
    $sku = get_post_meta(get_the_ID(), '_sku', true);
    if ($sku) {
        if (!isset($sku_counts[$sku])) {
            $sku_counts[$sku] = [];
        }
        $sku_counts[$sku][] = get_the_ID();
    }
}

foreach ($sku_counts as $sku => $posts) {
    if (count($posts) > 1) {
        error_log('Duplicate SKU: ' . $sku . ' in products: ' . implode(',', $posts));
    }
}
wp_reset_postdata();

2. Исправьте дубли вручную или программно

Варианты исправления:

• Вручную через админку WooCommerce — удобен для малого количества товаров.
• Программно — если товаров много, можно добавить суффикс к SKU, например, ID товара.

Пример кода для исправления дублирующихся SKU, добавляя ID товара к артикулу:

function fix_duplicate_skus() {
    $args = [
        'post_type' => 'product',
        'posts_per_page' => -1,
        'meta_query' => [
            [
                'key' => '_sku',
                'compare' => 'EXISTS',
            ],
        ],
    ];
    $query = new WP_Query($args);

    $sku_map = [];

    while ($query->have_posts()) {
        $query->the_post();
        $post_id = get_the_ID();
        $sku = get_post_meta($post_id, '_sku', true);
        if ($sku) {
            if (isset($sku_map[$sku])) {
                // Дубликат найден — исправляем
                $new_sku = $sku . '-' . $post_id;
                update_post_meta($post_id, '_sku', $new_sku);
                error_log("SKU для товара $post_id изменен с $sku на $new_sku");
            } else {
                $sku_map[$sku] = $post_id;
            }
        }
    }
    wp_reset_postdata();
}
add_action('init', 'fix_duplicate_skus');

3. Предотвращение появления дубликатов

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

function validate_unique_sku($post_id) {
    if (get_post_type($post_id) !== 'product') {
        return;
    }
    $sku = get_post_meta($post_id, '_sku', true);
    if (!$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,
        $post_id
    );
    $existing = $wpdb->get_var($query);

    if ($existing) {
        wp_die('Ошибка: этот SKU уже используется другим товаром. Пожалуйста, выберите уникальный SKU.');
    }
}
add_action('save_post', 'validate_unique_sku', 10, 1);

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

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

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

• Ошибка: Дублирование SKU после импорта товаров.
  Причина: Импорт без проверки уникальности.
  Решение: Используйте плагины импорта с настройкой проверки уникальности SKU или добавляйте уникальные префиксы/суффиксы.
• Ошибка: Ошибка при сохранении товара из-за проверки SKU.
  Причина: Проверка срабатывает на не продуктовые посты.
  Решение: Убедитесь, что проверка вызывается только для 'product' в save_post.
• Ошибка: Неудобство массового исправления SKU.
  Решение: Используйте WP-CLI или SQL-запросы для массовых правок.

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

• Безопасность: При добавлении пользовательских проверок избегайте вывода подробных ошибок пользователям — лучше перенаправлять с сообщением.
• Производительность: При большом количестве товаров используйте WP-CLI или SQL напрямую, чтобы избежать перегрузки сервера при массовых операциях.
• Резервное копирование: Перед массовыми исправлениями всегда делайте бэкап базы данных.

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