Как избежать проблем с кешированием в WooCommerce при использовании Varnish

Диагностика проблемы: почему Varnish мешает работе WooCommerce

Varnish — мощный HTTP-ускоритель, часто используемый для кеширования страниц и ускорения загрузки сайтов WordPress. Однако WooCommerce активно работает с динамическим контентом (корзина, личный кабинет), который нельзя кешировать без потери функциональности.

Типичные симптомы неправильной настройки Varnish для WooCommerce:

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

Если вы используете Varnish и столкнулись с такими проблемами, скорее всего, кешируются страницы и запросы, которые должны быть динамическими.

Пошаговое решение: правильная конфигурация Varnish для WooCommerce

1. Исключить из кеширования страницы WooCommerce

Нужно запретить кешировать все страницы, связанные с корзиной, оформлением заказа и аккаунтом пользователя.

sub vcl_recv {
    if (req.method == "POST") {
        return (pass);
    }

    if (req.url ~ "(cart|checkout|my-account|addons|order-tracking)") {
        return (pass);
    }

    # Дополнительно: отключаем кеш для админки и REST API
    if (req.url ~ "wp-admin" || req.url ~ "wp-json") {
        return (pass);
    }
}

2. Отключить кеширование куки, влияющих на динамический контент

WooCommerce использует куки, например woocommerce_cart_hash и woocommerce_items_in_cart, для определения состояния корзины.

sub vcl_recv {
    if (req.http.Cookie) {
        if (req.http.Cookie ~ "woocommerce_cart_hash" || req.http.Cookie ~ "woocommerce_items_in_cart" || req.http.Cookie ~ "wp_woocommerce_session_") {
            return (pass);
        }
    }
}

3. Правильно настроить заголовки кеширования

В ответах сервера WordPress должны быть заголовки, запрещающие кеширование динамического контента.

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

add_action('send_headers', function() {
    if (is_cart() || is_checkout() || is_account_page()) {
        header('Cache-Control: no-cache, no-store, must-revalidate');
        header('Pragma: no-cache');
        header('Expires: 0');
    }
});

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

• Добавьте товар в корзину как анонимный пользователь, затем обновите страницу — количество товаров в корзине должно корректно отображаться.
• Зайдите в личный кабинет — данные должны быть персональными и не смешиваться с другими пользователями.
• Проверьте в браузере, что страницы корзины и оформления заказа не кешируются (проверить заголовки Cache-Control и Pragma через инструменты разработчика).

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

• Пропущены страницы из исключений кеша. Если забыть указать в конфигурации страницы my-account или order-tracking, динамический контент будет кешироваться и работать некорректно.
• Не обработаны куки WooCommerce. Это приводит к тому, что Varnish отдает старую закешированную страницу даже при изменениях в корзине.
• Неправильные заголовки на стороне WordPress. Если сервер не отправляет заголовки, запрещающие кеширование, Varnish их проигнорирует.
• Кеширование POST-запросов. WooCommerce активно использует POST. Их необходимо всегда пропускать (pass) в Varnish.

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

• Используйте отдельные backend-серверы для админки и фронтенда, чтобы минимизировать нагрузку на кеш.
• Ограничьте кеширование только для GET-запросов, всегда пропускайте POST.
• Регулярно проверяйте обновления WooCommerce и Varnish, чтобы учитывать изменения в их API и особенностях работы.
• Для тонкой настройки используйте логирование Varnish (varnishlog) — поможет отследить, какие запросы кешируются и почему.

Сравнение подходов к решению проблемы кеширования WooCommerce с Varnish