WooCommerce: SKU не обновляется при редактировании товара — как исправить

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

В WooCommerce при редактировании товара иногда возникает ситуация, когда поле SKU (артикул) не обновляется или не сохраняется, хотя вы явно изменяете его в админке. Это приводит к тому, что старый артикул остается в базе, и новые данные не применяются. Проблема встречается как с простыми товарами, так и с вариативными.

Основные причины:

• Конфликт с плагинами, перехватывающими сохранение метаданных товара;
• Проблемы в теме, которая переопределяет стандартное поведение сохранения;
• Ошибки в пользовательских функциях, подключенных к хукам save_post или woocommerce_process_product_meta;
• Кэширование или оптимизации на стороне сервера мешают обновлению данных.

Как проверить, что SKU не сохраняется корректно

Для диагностики:

1. Откройте товар в админке WooCommerce, измените SKU на уникальное значение и сохраните.
2. Обновите страницу товара и проверьте, сохранилось ли новое значение.
3. Если SKU не изменился, подключите логирование ошибок PHP и включите WP_DEBUG в wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Проверьте файл wp-content/debug.log на наличие ошибок при сохранении товара.

Пошаговое решение проблемы с сохранением SKU в WooCommerce

1. Отключение конфликтующих плагинов

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

2. Проверка темы

Переключитесь на стандартную тему WordPress (например, Twenty Twenty-Three) и повторите тест. Если в стандартной теме проблема отсутствует, значит ваша тема вмешивается в процесс сохранения.

3. Использование правильного хука для сохранения SKU

Если в проекте есть кастомный код для обработки SKU, убедитесь, что он использует официальный хук WooCommerce woocommerce_process_product_meta. Пример корректного кода:

add_action('woocommerce_process_product_meta', 'custom_save_product_sku');
function custom_save_product_sku($post_id) {
    if (isset($_POST['_sku'])) {
        $sku = sanitize_text_field($_POST['_sku']);
        update_post_meta($post_id, '_sku', $sku);
    }
}

Этот код гарантирует правильное сохранение SKU при обновлении товара.

4. Очистка кэша и перезапуск сервера

Если используется серверное кэширование (например, Redis, Memcached) или плагины для кэширования, очистите кэш после внесения изменений. Иногда старые данные остаются в кеше и не дают увидеть обновления.

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

После внесения изменений повторите действия из раздела диагностики:

• Отредактируйте SKU товара в админке;
• Сохраните и обновите страницу;
• Убедитесь, что новое значение SKU отображается и сохраняется;
• Проверьте на фронтенде, если SKU выводится в карточке товара.

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

• Использование неправильных хуков для сохранения SKU
  Некорректное подключение к хукам save_post без проверки типа поста или без корректной обработки данных приводит к конфликтам. Исправление — использовать woocommerce_process_product_meta и проверять входящие данные.
• Отсутствие проверки nonce и прав пользователя
  Без проверки nonce и прав доступа код может работать нестабильно или не выполняться. Включите проверку check_admin_referer и возможностей пользователя.
• Плагин кэширования мешает обновлению
  Проверьте, не кэширует ли плагин админку или страницы редактирования товара. Отключите кэширование для админ-панели.
• Конфликт с WooCommerce или WP обновлениями
  Проверьте, что WooCommerce и WordPress обновлены до последних стабильных версий.

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

• При сохранении SKU всегда используйте sanitize_text_field для очистки данных.
• Проверяйте права пользователя, чтобы избежать несанкционированного изменения товаров:

if (!current_user_can('edit_product', $post_id)) {
    return;
}

• Избегайте избыточных запросов к базе при сохранении мета, используйте update_post_meta только при изменении значения.
• Для больших магазинов настройте серверное кэширование с исключением админ-панели и страниц редактирования товаров.

Сравнение вариантов решения проблемы с SKU