WooCommerce登录/未登录内容缓存问题求助

问题描述 #

我们需要实现一个页面，根据用户登录状态展示不同内容：登录且拥有custom_user_role角色的用户可查看私有内容，未登录或无对应角色的用户仅显示登录页面链接。但遇到问题：用户登录后返回原页面时，页面仍显示未登录状态的内容（类似被浏览器缓存），必须手动刷新才能加载正确内容。

测试环境为全新空白WordPress/WooCommerce安装，未使用缓存插件，在Chrome、Firefox及多台设备上均复现该问题。仅在Chrome开启“Disable cache”选项时，无需刷新即可正确加载内容。

使用的代码如下：

$current_user = wp_get_current_user();

if(!user_can($current_user, "custom_user_role")){ ?>
    <p>You are not permitted to view this page. Please <a href="/my-account">log in or sign up</a>.</p><?php
}else{ ?>
    <p>You are logged in</p><?php
}

解决方法 #

1. 禁用浏览器页面缓存（简便方案） #

在页面添加HTTP缓存控制头，告诉浏览器不要缓存该页面内容。可以在主题的functions.php中添加以下代码，或直接在目标页面顶部插入：

// 为目标页面禁用缓存
function disable_dynamic_page_caching() {
    // 替换成你的目标页面slug或ID
    if (is_page('private-content-page')) { 
        header("Cache-Control: no-cache, no-store, must-revalidate"); // HTTP 1.1标准
        header("Pragma: no-cache"); // 兼容HTTP 1.0
        header("Expires: 0"); // 设置过期时间为过去，强制浏览器不缓存
    }
}
add_action('template_redirect', 'disable_dynamic_page_caching');

配置后，浏览器会每次请求最新页面内容，登录返回后直接显示正确状态。

2. 登录成功后强制刷新页面 #

如果不想全局禁用缓存，可通过WooCommerce登录钩子，在用户登录返回原页面时自动刷新。在functions.php中添加：

// 登录重定向时添加刷新标记
function add_refresh_param_on_login_redirect($redirect_to, $request, $user) {
    // 检查是否从目标页面跳转至登录页
    if (!empty($request) && strpos($request, 'private-content-page') !== false) {
        $redirect_to = add_query_arg('force_refresh', '1', $redirect_to);
    }
    return $redirect_to;
}
add_filter('woocommerce_login_redirect', 'add_refresh_param_on_login_redirect', 10, 3);

// 检测刷新参数并强制页面重载
function force_page_refresh_after_login() {
    if (is_page('private-content-page') && isset($_GET['force_refresh'])) {
        ?>
        <script>
            // 移除URL中的刷新参数并强制从服务器加载
            const cleanUrl = window.location.href.split('?')[0];
            window.location.replace(cleanUrl);
            window.location.reload(true);
        </script>
        <?php
        exit;
    }
}
add_action('template_redirect', 'force_page_refresh_after_login');

该方案会在用户从目标页面登录后返回时，自动触发页面刷新，确保加载最新登录状态的内容。

3. 给登录链接添加随机参数（临时快速方案） #

修改原代码中的登录链接，添加随机参数让浏览器识别为新请求：

<p>You are not permitted to view this page. Please <a href="/my-account?nocache=<?php echo rand(); ?>">log in or sign up</a>.</p>

每次点击登录链接时，URL会携带不同的随机数，登录返回原页面时，浏览器不会调用缓存的旧内容。

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