Если в WooCommerce корзина открывается, но мини-корзина не обновляется, значок количества товаров зависает или на странице оформления заказа появляются странные задержки, часто проблема не в самом заказе, а в механизме cart fragments. Это тот случай, когда фронтенд пытается подгрузить актуальное состояние корзины через AJAX, но запросы не доходят, получают битый ответ или конфликтуют с кэшем и сторонними скриптами.
Ниже разберём, как локализовать источник ошибки, что именно проверить в теме и плагинах, и как безопасно исправить ситуацию без отключения нужного функционала.
Когда проблема действительно в cart fragments
Не стоит сразу править код. Сначала убедитесь, что симптомы совпадают с типичным сбоем WooCommerce. Обычно это выглядит так:
- мини-корзина не меняется после добавления товара;
- счётчик товаров в шапке остаётся старым до перезагрузки страницы;
- после добавления товара в корзину страница оформления заказа ведёт себя нестабильно;
- в консоли браузера есть ошибки JavaScript, связанные с
wc-cart-fragmentsилиwoocommerce; - в Network виден запрос к
?wc-ajax=get_refreshed_fragments, который возвращает 400/403/500 или HTML вместо JSON.
Важно: если ломается только оформление заказа, а корзина и мини-корзина работают нормально, причина может быть не в fragments, а в шаблоне checkout, конфликте полей доставки или переопределении хуков WooCommerce. Но проверку fragments всё равно стоит сделать первой — это быстрый и показательный тест.
Диагностика проблемы: что смотреть в первую очередь
1. Проверка запроса в браузере
Откройте страницу с мини-корзиной, затем DevTools → Network и найдите запрос get_refreshed_fragments. Нормальный ответ обычно приходит в JSON и содержит фрагменты HTML для мини-корзины. Если вместо этого вы видите редирект, страницу авторизации, HTML ошибки или пустой ответ, WooCommerce не может корректно обновить состояние корзины.
Полезно также посмотреть вкладку Console. Если там есть ошибки вида Uncaught TypeError или Cannot read properties of undefined, часто виноват другой скрипт, который ломает выполнение JS до запуска WooCommerce.
2. Проверка кэша и оптимизации
Cart fragments плохо уживаются с агрессивной оптимизацией. Типовые причины:
- страница корзины или оформления заказа закэширована как обычная статическая страница;
- JS объединён и отложен так, что
wc-cart-fragmentsзапускается слишком поздно; - мини-корзина подменяется шаблоном темы, но без нужных хуков WooCommerce;
- CDN или серверный кэш отдаёт старый HTML с уже неактуальным nonce или ссылками.
Если у вас стоит плагин оптимизации, проверьте исключения для страниц /cart/, /checkout/ и /my-account/. Для мини-корзины часто нужно отдельно исключить скрипты WooCommerce из defer/delay.
3. Проверка темы и переопределений
В некоторых темах мини-корзина собрана вручную и не использует стандартные шаблоны WooCommerce. Тогда запросы fragments могут работать, но результат не вставляется в DOM из-за нестандартной разметки. Сравните текущий шаблон шапки с базовым выводом WooCommerce и проверьте, не переопределены ли файлы woocommerce/cart/mini-cart.php или связанные части header.
| Подход | Что даёт | Минус |
|---|---|---|
| Плагин оптимизации | Быстрое исключение страниц и скриптов | Нужно аккуратно настраивать исключения |
| Код в теме/плагине | Точный контроль над поведением WooCommerce | Требует проверки после обновлений |
| Отключение fragments | Убирает источник лишних запросов | Мини-корзина перестаёт обновляться без перезагрузки |
Пошаговое решение без лишних рисков
Шаг 1. Исключите страницы WooCommerce из кэша
Для начала отключите кэширование корзины и оформления заказа на уровне плагина или сервера. Если используется Nginx FastCGI cache, Cloudflare или другой reverse proxy, убедитесь, что эти страницы не отдаются из кэша для гостей. Для WooCommerce это базовое требование, иначе fragments могут получать устаревший HTML.
Если вы не уверены, что именно кэшируется, проверьте заголовки ответа в браузере: cache-control, x-cache, cf-cache-status. Страницы cart и checkout не должны вести себя как обычные публичные лендинги.
Шаг 2. Ограничьте загрузку cart fragments там, где они не нужны
На многих сайтах скрипт wc-cart-fragments грузится на каждой странице, даже если мини-корзина нигде не отображается. Это не всегда ошибка, но лишняя нагрузка есть. Если у вас нет мини-корзины в шапке, можно отключить этот скрипт на страницах, где он не нужен.
<?php
add_action( 'wp_enqueue_scripts', function() {
if ( function_exists( 'is_woocommerce' ) && ! is_woocommerce() && ! is_cart() && ! is_checkout() ) {
wp_dequeue_script( 'wc-cart-fragments' );
wp_deregister_script( 'wc-cart-fragments' );
}
}, 20 );Этот вариант подходит только если вы точно знаете, что тема не использует мини-корзину вне WooCommerce-страниц. Если в шапке есть виджет корзины, отключение сломает обновление счётчика.
Шаг 3. Проверьте, не ломает ли JS другой плагин
Если запрос get_refreshed_fragments есть, но фронтенд не обновляется, временно отключите плагины оптимизации, кеширования, минификации и плагины, которые меняют шапку или AJAX-поведение. Затем проверьте:
- обновляется ли мини-корзина на стандартной теме;
- исчезает ли ошибка в консоли;
- меняется ли ответ запроса fragments после отключения конкретного плагина.
Если проблема исчезла, включайте плагины по одному. Так быстрее найти конфликт, чем гадать по симптомам.
Шаг 4. Добавьте точечную защиту от битого ответа
Иногда сторонний код подмешивает лишний вывод в AJAX-ответ: пробелы, notices, варнинги PHP, HTML от debug-плагина. Для WooCommerce это критично, потому что fragments ожидают структурированный ответ. В таком случае нужно убрать источник вывода, а не маскировать проблему.
<?php
add_action( 'init', function() {
if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
ini_set( 'display_errors', '0' );
}
} );Это не замена нормальной отладки, а способ не ломать AJAX-ответы на боевом сайте. Ошибки лучше писать в лог, а не выводить в браузер.
Как проверить, что решение сработало
После правок не ограничивайтесь визуальной проверкой. Пройдите короткий чек-лист:
- добавьте товар в корзину и убедитесь, что счётчик в шапке меняется без перезагрузки;
- откройте Network и проверьте, что
get_refreshed_fragmentsвозвращает корректный JSON; - очистите кэш плагина, серверный кэш и CDN, затем повторите тест;
- проверьте корзину и checkout в инкогнито, чтобы исключить влияние cookies и сессий;
- если есть мобильная версия шапки, протестируйте её отдельно — там часто другой шаблон мини-корзины.
Если после очистки кэша всё работает только в админке или только у авторизованного пользователя, значит проблема ещё осталась на уровне кэширования или условий вывода шаблона.
Частые ошибки и как их исправить
Отключили cart fragments, но оставили мини-корзину в шапке
В этом случае счётчик и содержимое корзины перестают обновляться. Решение простое: либо вернуть скрипт, либо убрать динамическую мини-корзину и сделать обновление только после перехода на страницу корзины.
Исключили страницы из кэша, но забыли про AJAX-эндпоинт
Некоторые прокси и WAF фильтруют запросы к ?wc-ajax=get_refreshed_fragments. Если на сервере есть правила безопасности, проверьте, не блокируют ли они этот URL по шаблону. Особенно часто это случается после жёсткой настройки ModSecurity.
Включили defer для всех скриптов подряд
WooCommerce-скрипты не всегда безболезненно переживают отложенную загрузку. Если мини-корзина и checkout ломаются после оптимизации, исключите wc-cart-fragments, woocommerce и связанные скрипты из defer/delay и протестируйте снова.
Смотрят только на фронтенд, игнорируя PHP notices
Даже один notice в AJAX-ответе может испортить JSON. Проверьте debug.log и временно отключите вывод ошибок на экран. Если в ответе есть лишний HTML, сначала уберите источник, потом уже тестируйте WooCommerce.
Безопасность и производительность: что имеет смысл сделать сразу
Если сайт нагружен и корзина используется часто, не ограничивайтесь точечным исправлением. Проверьте ещё несколько вещей:
- не грузится ли мини-корзина на страницах, где она не нужна;
- нет ли лишних AJAX-запросов от темы и виджетов;
- не дублируются ли скрипты WooCommerce после ручного подключения в шаблоне;
- не сохраняются ли ошибки PHP в вывод страницы вместо лога;
- не ломает ли CDN cookies WooCommerce.
Если нужен более системный аудит дублей, кэша и лишних скриптов, на практике удобно использовать Clearfy Pro: он помогает убрать часть мусорных подключений и сократить количество конфликтов в шаблоне, но даже с ним логику WooCommerce всё равно нужно проверять руками.
Главное правило здесь простое: не лечите cart fragments полным отключением AJAX, если магазин реально использует мини-корзину. Сначала найдите, что именно ломает ответ или его обработку, и только потом упрощайте поведение.