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

Диагностика проблемы повторной отправки писем при смене статуса заказа в WooCommerce

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

Проверить наличие проблемы можно следующим образом:

• Открыть заказ в панели WooCommerce;
• Изменить статус заказа вручную на тот же, который уже установлен;
• Обратить внимание, отправляется ли письмо повторно.

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

Почему возникает повторная отправка писем

По умолчанию WooCommerce отправляет уведомления при изменении статуса с помощью хуков woocommerce_order_status_{from}_to_{to}. Но если статус меняется программно или вручную на текущий, эти хуки могут сработать повторно.

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

Пошаговое решение: как предотвратить повторную отправку писем

1. Добавить проверку текущего статуса перед отправкой письма

В файле functions.php вашей темы или в кастомном плагине добавьте следующий код, который отменит отправку письма, если статус не изменился:

add_action('woocommerce_email_before_send', function($email) {
    // Перехватываем email уведомления о смене статуса
    if (!in_array($email->id, ['customer_processing_order', 'customer_completed_order'])) {
        return;
    }

    $order = $email->object;
    if (!$order instanceof WC_Order) {
        return;
    }

    // Получаем предыдущий статус из мета заказа
    $prev_status = get_post_meta($order->get_id(), '_previous_order_status', true);
    $current_status = $order->get_status();

    // Если статус не изменился, отменяем отправку
    if ($prev_status === $current_status) {
        remove_action('woocommerce_email_before_send', [$email, 'trigger']);
    } else {
        // Обновляем предыдущий статус
        update_post_meta($order->get_id(), '_previous_order_status', $current_status);
    }
}, 10, 1);

Этот код сохраняет последний статус заказа в мета-данных и сравнивает с текущим перед отправкой письма. Если статус совпадает, письмо не отправляется.

2. Корректное использование хуков изменения статуса

Лучше контролировать смену статуса через хук woocommerce_order_status_changed, который передает старый и новый статусы. Можно отсеять повторные смены статуса:

add_action('woocommerce_order_status_changed', function($order_id, $old_status, $new_status) {
    if ($old_status === $new_status) {
        // Не обрабатываем, если статус не изменился
        return;
    }
    // Обновляем мета с текущим статусом
    update_post_meta($order_id, '_previous_order_status', $new_status);
}, 10, 3);

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

• В панели WooCommerce откройте заказ с известной проблемой.
• Попробуйте изменить статус на тот же, что уже установлен.
• Убедитесь, что письмо не отправляется повторно.
• Проверьте смену статуса на новый — письмо должно отправиться.

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

• Ошибка: Письма всё равно отправляются повторно при сохранении заказа.
  Причина: Код не добавлен в нужный хук, или конфликтует с другими плагинами.
  Решение: Используйте отладку с error_log и убедитесь, что код выполняется после загрузки WooCommerce.
• Ошибка: Письма не отправляются вообще.
  Причина: Некорректно отключена отправка, удалён нужный хук.
  Решение: Проверьте логи и уберите лишние remove_action.
• Ошибка: Метаданные статуса не обновляются.
  Причина: Отсутствует вызов обновления мета при смене статуса.
  Решение: Добавьте обработчик на woocommerce_order_status_changed для актуализации мета.

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

• Не используйте тяжелые запросы в хук отправки email — лучше хранить и проверять статусы через мета.
• Кэшируйте результаты, если отправка писем связана с внешними API.
• Всегда тестируйте на staging-сайте перед внедрением на продакшн.

Сравнение методов предотвращения повторной отправки писем