WooCommerce: не работает обновление данных заказа после изменения статуса — решение

Диагностика проблемы: почему данные заказа не обновляются после смены статуса

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

Также причиной может быть некорректная работа пользовательского кода или конфликт с плагинами, которые перехватывают процесс обновления заказа.

Как проверить проблему

• Активируйте логирование WooCommerce (WooCommerce > Статус > Логи) и посмотрите, фиксируются ли изменения статуса.
• Добавьте временный код для отладки в ваш functions.php или плагин, чтобы логировать вызовы хуков:

add_action('woocommerce_order_status_changed', function($order_id, $old_status, $new_status) {
    error_log("Order #$order_id changed from $old_status to $new_status");
}, 10, 3);

Если в логах нет записей, значит хук не срабатывает при смене статуса.

Пошаговое решение: правильное обновление заказа при смене статуса

1. Используйте правильный хук для обработки изменений статуса

Для полной уверенности, что обработка данных заказа сработает, используйте хук woocommerce_order_status_{$new_status}, который срабатывает сразу после смены на конкретный статус.

add_action('woocommerce_order_status_completed', 'custom_order_completed_handler');
function custom_order_completed_handler($order_id) {
    $order = wc_get_order($order_id);
    // Обновляем метаданные
    $order->update_meta_data('custom_key', 'custom_value');
    $order->save();
}

Подставьте нужный статус вместо completed.

2. Для обработки всех смен статусов — универсальный хук

add_action('woocommerce_order_status_changed', 'custom_order_status_changed', 10, 3);
function custom_order_status_changed($order_id, $old_status, $new_status) {
    $order = wc_get_order($order_id);
    // Пример: сбросить кеш или обновить поля
    $order->update_meta_data('last_status_change', current_time('mysql'));
    $order->save();
}

3. Проверка массовых изменений

Если вы меняете статусы массово (например, из админки или скриптом), убедитесь, что используете API WooCommerce, а не прямое обновление БД. Пример правильного массового обновления:

$orders = wc_get_orders(['status' => 'processing', 'limit' => -1]);
foreach ($orders as $order) {
    $order->update_status('completed', 'Автоматическое обновление статуса');
}

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

• Измените статус одного заказа в админке WooCommerce и проверьте, что ваш код срабатывает (через логи или вывод на экран).
• Убедитесь, что метаданные или другие данные обновились, например, через функцию get_post_meta($order_id, 'custom_key', true) или просмотр в базе данных.
• Для массовых операций — проверьте несколько заказов.

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

• Хук не срабатывает: проверьте правильность названия хука, при программном изменении статуса используйте метод $order->update_status(), а не прямое изменение БД.
• Данные не сохраняются: не забудьте вызвать $order->save() после внесения изменений.
• Конфликты с другими плагинами: временно отключите сторонние плагины, чтобы проверить, не блокируют ли они обработку событий.
• Кэширование: если используете кэширование объектов заказа, убедитесь, что оно обновляется после изменений.

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

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

Сравнение подходов обновления заказа

Метод	Преимущества	Недостатки
Прямое обновление БД	Быстрое, если нужно много данных	Хуки не срабатывают, возможны ошибки данных
Использование $order->update_status()	Все хуки и события срабатывают корректно	Медленнее при массовых обновлениях
Хуки woocommerce_order_status_{$new_status}	Точный контроль на конкретный статус	Нужно писать обработчик для каждого статуса
Хук woocommerce_order_status_changed	Универсальный, для всех статусов	Обработка может быть избыточной