WP Rocket插件问题：非购物车页面顶部迷你购物车数量无法自动更新

这个问题我碰到过好多次，核心原因是WP Rocket的页面静态缓存会把页面内容存起来，而你的count_cart()函数是依赖PHP Session来计数的——缓存后的页面不会每次加载都重新执行这段PHP代码，自然没法实时更新购物车数量。给你几个针对性的解决方案，按优先级排序：

1. 排除迷你购物车区域的动态缓存（最快见效） #

WP Rocket自带动态内容排除功能，能让页面其他部分保持缓存，只实时渲染购物车计数区域：

• 先找到你页面中显示购物车数量的HTML容器，比如你的代码输出的计数应该是放在类似<span class="mini-cart-count"><?php echo count_cart(); ?></span>这样的标签里，记下它的CSS选择器（比如.mini-cart-count）
• 进入WP Rocket后台，到「高级」→「动态内容」选项卡，在「动态内容选择器」里添加这个选择器（比如.mini-cart-count）
• 另外建议把你count_cart()函数里的@session_start()改成if (!session_id()) session_start();，避免和WordPress自带的session机制冲突，去掉错误抑制符也方便排查问题：

  function count_cart() {
      if (!session_id()) session_start();
      if(isset($_SESSION['cart']) && is_array($_SESSION['cart'])){
          $count = count($_SESSION['cart']).' SP';
      } else {
          $count = '0';
      }
      return $count;
  }
  

• 最后清空WP Rocket的缓存，测试一下——现在购物车计数区域会每次都实时执行PHP代码读取Session了。

2. 用AJAX实现实时更新（最彻底的用户体验） #

上面的方法能解决页面刷新后的计数问题，但用户点击「添加到购物车」后，当前页面的计数不会自动刷新，还是需要刷新页面才能看到变化。用AJAX可以实现无刷新更新：

第一步：注册AJAX回调函数（在主题的functions.php里添加） #

// 给登录/未登录用户都注册AJAX接口
add_action('wp_ajax_get_cart_count', 'ajax_get_cart_count');
add_action('wp_ajax_nopriv_get_cart_count', 'ajax_get_cart_count');

function ajax_get_cart_count() {
    if (!session_id()) session_start();
    $count = isset($_SESSION['cart']) && is_array($_SESSION['cart']) ? count($_SESSION['cart']) . ' SP' : '0';
    echo $count;
    wp_die(); // 必须结束AJAX请求
}

// 加载JS并传递AJAX地址
add_action('wp_enqueue_scripts', 'enqueue_cart_ajax_script');
function enqueue_cart_ajax_script() {
    wp_enqueue_script('cart-update-script', get_template_directory_uri() . '/js/cart-update.js', array('jquery'), '1.0', true);
    wp_localize_script('cart-update-script', 'wpAjax', array(
        'ajaxurl' => admin_url('admin-ajax.php')
    ));
}

第二步：编写AJAX逻辑（在主题的js/cart-update.js里添加） #

document.addEventListener('DOMContentLoaded', function() {
    const cartCountEl = document.querySelector('.mini-cart-count');
    const addToCartButtons = document.querySelectorAll('.add-to-cart-btn'); // 替换成你实际的添加按钮选择器

    // 页面加载时先获取一次最新计数，覆盖缓存的旧值
    updateCartCount();

    // 监听添加到购物车的点击事件，更新计数
    addToCartButtons.forEach(btn => {
        btn.addEventListener('click', function() {
            // 可以在这里加个加载状态提示
            if (cartCountEl) cartCountEl.textContent = '...';
            setTimeout(updateCartCount, 500); // 延迟一下确保Session已更新
        });
    });

    function updateCartCount() {
        if (!cartCountEl) return;
        fetch(wpAjax.ajaxurl, {
            method: 'POST',
            headers: {
                'Content-Type': 'application/x-www-form-urlencoded'
            },
            body: 'action=get_cart_count'
        })
        .then(res => res.text())
        .then(count => {
            cartCountEl.textContent = count;
        })
        .catch(err => console.error('更新购物车计数失败:', err));
    }
});

3. 基于Cookie排除缓存（备选方案，缓存命中率会降低） #

如果上面的方法都不适用，可以让WP Rocket对有购物车Session的用户不缓存页面：

• 进入WP Rocket的「高级」→「缓存排除」，在「Cookie 名称」里添加PHPSESSID（PHP默认的Session Cookie名称），这样只要用户有活跃的Session，WP Rocket就会跳过缓存，直接渲染动态页面。
• 这个方法的缺点是会降低缓存命中率，因为每个用户的页面都是动态生成的，所以优先用前两个方法。

记得每次修改后都要清空WP Rocket的缓存，然后测试添加商品到购物车的流程哦。

内容的提问来源于stack exchange，提问作者Johnny Duong