如何在不使用wp_query的WordPress自定义页面用保留参数实现分页

问题根源 #

你遇到的404错误，是因为WordPress会自动解析page参数，尝试加载对应分页的内置内容，但你的页面内容来自外部后端、未使用WP_Query，导致系统找不到匹配的分页内容，最终返回404。仅禁用redirect_canonical重定向不足以解决问题，还需要让WordPress忽略对page参数的默认分页处理。

解决方案代码 #

// 禁用目标页面的canonical重定向，保留page参数
function custom_keep_page_param($redirect_url, $requested_url) {
    // 匹配你的自定义页面（可替换为页面ID或slug）
    if (is_page('baskets-femme')) {
        if (strpos($requested_url, '?page=') !== false) {
            return $requested_url; // 保留原URL，不执行重定向
        }
    }
    return $redirect_url;
}
add_filter('redirect_canonical', 'custom_keep_page_param', 10, 2);

// 让WordPress忽略page参数的内置分页逻辑，避免404
function custom_ignore_page_param($query_vars) {
    if (is_page('baskets-femme') && isset($_GET['page'])) {
        // 移除WordPress默认的page查询变量，阻止内置分页触发
        unset($query_vars['page']);
        // 将page参数存入自定义变量，方便后续安全调用
        $query_vars['custom_page'] = $_GET['page'];
    }
    return $query_vars;
}
add_filter('query_vars', 'custom_ignore_page_param');

代码说明 #

1. custom_keep_page_param函数：针对目标自定义页面，当URL包含page参数时，阻止WordPress的规范URL重定向，保留带参数的原URL。
2. custom_ignore_page_param函数：通过query_vars过滤器移除WordPress默认的page查询变量，避免系统尝试加载不存在的内置分页内容；同时将page参数值存入自定义变量custom_page，替代直接使用$_GET['page']，提升安全性。

页面模板中获取分页参数 #

在你的自定义页面模板里，用以下方式安全获取当前分页值：

// 获取分页值，默认显示第1页
$current_page = get_query_var('custom_page', 1);
// 验证参数为正整数
$current_page = absint($current_page);
$current_page = $current_page < 1 ? 1 : $current_page;

之后即可使用$current_page请求外部后端接口，加载对应分页的商品数据。

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