Как отладить проблемы со статусами заказов WooCommerce

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

Статусы заказов — одна из ключевых частей бизнес-логики WooCommerce. Ошибки в их работе приводят к неверному учёту, сбоям в автоматизации отправки уведомлений и неправильному отображению информации для клиентов. Основные симптомы проблем:

• Статус заказа не меняется после оплаты;
• Кастомные статусы не отображаются или не работают в админке;
• Автоматические действия (уведомления, смена статусов) не срабатывают;
• Не работают хуки на изменение статусов.

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

Проверка журналов WooCommerce и WP_DEBUG

Включите режим отладки в wp-config.php:

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

Затем проверьте wp-content/debug.log на ошибки, связанные с обработкой заказов и сменой статусов.

В WooCommerce активируйте отладку платежных шлюзов: WooCommerce → Настройки → Платежи → выберите шлюз → Включите логирование.

Пошаговое решение: отладка и исправление

1. Проверка стандартных статусов и смены через админку

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

2. Проверка хуков для смены статуса

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

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

Если в debug.log нет подобных записей при смене статуса — проблема на уровне ядра WooCommerce или блокировки хуков.

3. Проверка кастомных статусов

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

function register_custom_order_statuses() {
    register_post_status('wc-awaiting-shipment', array(
        'label' => 'Ожидает отправки',
        'public' => true,
        'exclude_from_search' => false,
        'show_in_admin_all_list' => true,
        'show_in_admin_status_list' => true,
        'label_count' => _n_noop('Ожидает отправки <span class="count">(%s)</span>', 'Ожидает отправки <span class="count">(%s)</span>'),
    ));
}
add_action('init', 'register_custom_order_statuses');

function add_custom_status_to_order_list($order_statuses){
    $order_statuses['wc-awaiting-shipment'] = 'Ожидает отправки';
    return $order_statuses;
}
add_filter('wc_order_statuses', 'add_custom_status_to_order_list');

Проверьте, что в админке и фронтенде статус отображается корректно.

4. Проверка взаимодействия с платежными шлюзами

Некоторые шлюзы сами меняют статус после успешной оплаты. Проверьте логи шлюза и настройте правильное соответствие статусов в настройках плагина платежного шлюза.

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

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

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

• Создайте новый заказ через фронтенд и оплатите тестовым платежом (sandbox).
• Убедитесь, что статус автоматически меняется согласно логике вашего магазина.
• Проверьте логи (debug.log и логи платежного шлюза) на отсутствие ошибок.
• Проверьте работу автоматических действий, например, отправку email при смене статуса.

Частые ошибки и способы исправления

• Статус не меняется автоматически после оплаты: проверьте правильность настроек платежного шлюза и наличие обновлений плагина.
• Кастомный статус не отображается в списках заказов: проверьте регистрацию статуса и добавление в фильтр wc_order_statuses.
• Хуки woocommerce_order_status_changed не срабатывают: убедитесь, что код не конфликтует с другими плагинами, и что хуки добавлены в правильном месте.
• Проблемы с правами доступа: проверьте роли и права пользователя, который изменяет статусы.

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

• Не храните логи отладки на рабочем сайте долго — после устранения проблем отключайте WP_DEBUG.
• Используйте дочернюю тему или собственный плагин для добавления кастомного кода, чтобы не потерять изменения при обновлении.
• Оптимизируйте обработчики хуков, избегайте тяжелых операций при смене статуса, чтобы не замедлять сайт.
• Регулярно обновляйте WooCommerce и платежные плагины для совместимости и безопасности.

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