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

Почему в WooCommerce перестают обновляться статусы заказов после обновления плагина

После обновления WooCommerce могут возникнуть проблемы с автоматическим обновлением статусов заказов — например, заказ остаётся в статусе "Обработка", хотя оплата прошла успешно, или статус не меняется при смене этапа исполнения. Главные причины:

• Конфликты с плагинами, которые перехватывают хук woocommerce_order_status_changed.
• Изменения в ядре WooCommerce, требующие обновления кастомного кода.
• Проблемы с кешированием, из-за которых статус отображается некорректно.
• Ошибки сессий и куки, влияющие на AJAX-запросы обновления корзины и статусов.

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

Для диагностики выполните следующие шаги:

1. Включите режим отладки WooCommerce:
   

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

2. Проверьте файл wp-content/debug.log на наличие ошибок, связанных с заказами и хуками.
3. Отключите все плагины, кроме WooCommerce, и проверьте обновление статусов вручную через админку.
4. Переключитесь на стандартную тему (например, Storefront) для исключения влияния темы.
5. Используйте консоль браузера, чтобы проверить ошибки в AJAX-запросах (например, в wp-admin/admin-ajax.php).

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

1. Проверка и исправление кастомных хуков

Если вы использовали в functions.php или в плагинах хуки для изменения статусов, проверьте их актуальность. Например, правильный хук для отслеживания изменения статуса — woocommerce_order_status_changed:

add_action('woocommerce_order_status_changed', 'custom_order_status_handler', 10, 4);
function custom_order_status_handler($order_id, $old_status, $new_status, $order) {
    // Ваш код обработки
}

Убедитесь, что ваш код не вызывает фатальных ошибок и корректно обрабатывает параметры.

2. Очистка кеша и отключение оптимизаций

Если используется кеширование (например, плагин WP Rocket, серверный кеш, Cloudflare), очистите его полностью. Особенно важно отключить кеш страниц для страниц с заказами и страницы корзины.

3. Проверка сессий и куки

WooCommerce использует PHP-сессии и куки для отслеживания состояния заказа. Убедитесь, что сессии корректно работают, а в браузере нет блокировки куки.

В functions.php можно добавить временную проверку для логирования сессий:

add_action('init', function() {
    if (!session_id()) {
        session_start();
    }
    error_log('Session ID: ' . session_id());
});

4. Обновление WooCommerce и зависимостей

Иногда проблема кроется в несовместимости версии WooCommerce с версией WordPress или PHP. Проверьте требования WooCommerce и обновите при необходимости:

• PHP не ниже 7.4.
• WordPress не ниже 5.8.

5. Проверка AJAX-обработчиков WooCommerce

Обновление статусов часто происходит через AJAX. Проверьте, работают ли AJAX-запросы оплаты и обновления корзины. В консоли браузера должны отсутствовать ошибки 403, 500, 400.

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

• Создайте тестовый заказ и пройдите процесс оплаты в тестовом режиме (например, через платежный шлюз "Чек" или Sandbox).
• Проверьте, меняется ли статус заказа в админке и на странице "Мои заказы" пользователя.
• Проверяйте логи ошибок и AJAX-запросы в режиме разработчика браузера.
• Убедитесь, что после очистки кеша статус отображается правильно у разных пользователей и при разных браузерах.

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

• Ошибка: Кастомный код использует устаревшие хуки.
  Как исправить: заменить на woocommerce_order_status_changed и проверить параметры.
• Ошибка: Кеширование страниц мешает обновлению.
  Как исправить: исключить из кеша страницы корзины и заказов, отключить агрессивное кеширование.
• Ошибка: AJAX-запросы возвращают 403 Forbidden.
  Как исправить: проверить настройки безопасности сервера, .htaccess и плагины безопасности (например, Wordfence), добавить исключения для admin-ajax.php.
• Ошибка: Сессии PHP не стартуют, куки блокируются.
  Как исправить: проверить настройки PHP, headers, убедиться, что нет конфликтов с другими плагинами.

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

• Не используйте перехватчики статусов с тяжелыми операциями — это замедляет обработку заказов.
• Для логирования ошибок используйте WC_Logger вместо error_log — так логи будут в админке WooCommerce.
• Всегда тестируйте изменения в тестовом окружении перед обновлением на живом сайте.
• Регулярно обновляйте WooCommerce и плагины безопасности, чтобы избежать уязвимостей.

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