自定义文章类型下WordPress分页异常求助

核心问题分析 #

• 重定向触发原因：WordPress默认的固定链接规则会自动将带?paged=2的查询字符串格式URL重定向到/page/2/的路径式格式，这是Canonical URL功能的自动规范化行为。
• 404错误原因：当前使用的是页面模板（Page Template），而WordPress默认将/page/n/这类路径关联到博客首页或归档页面的分页逻辑，不会匹配自定义页面模板的路由，因此返回404。
• 查询变量不匹配：页面模板场景下，WordPress默认使用page作为分页查询变量，而非归档页面用的paged，导致分页参数无法被正确识别。
• 全局变量重置错误：代码中使用wp_reset_query()是错误的，该函数仅适用于query_posts()，自定义WP_Query应使用wp_reset_postdata()恢复全局$post变量。

分步修复方案 #

1. 修正分页查询变量的获取 #

将原代码中获取分页参数的代码替换为：

// 页面模板中使用page作为分页变量，而非paged
$paged = (get_query_var('page')) ? absint(get_query_var('page')) : 1;

同时更新paginate_links中的current参数：

'current'      => max(1, get_query_var('page')),

2. 禁用分页URL的自动重定向 #

在主题的functions.php中添加以下代码，阻止WordPress将分页查询字符串URL重定向到路径式格式：

add_filter('redirect_canonical', 'disable_page_paged_redirect', 10, 2);
function disable_page_paged_redirect($redirect_url, $requested_url) {
    if (strpos($requested_url, '?paged=') !== false || strpos($requested_url, '?page=') !== false) {
        return false;
    }
    return $redirect_url;
}

3. 修正全局变量重置函数 #

将原代码中的wp_reset_query();替换为：

wp_reset_postdata();

4. 可选：调整固定链接规则（若需保留路径式分页） #

如果希望使用/companies/page/2/这种路径格式而非查询字符串，需要为自定义页面模板添加重写规则。在functions.php中添加：

add_action('init', 'custom_page_pagination_rewrite');
function custom_page_pagination_rewrite() {
    add_rewrite_rule(
        '^companies/page/([0-9]+)/?$',
        'index.php?pagename=companies&page=$matches[1]',
        'top'
    );
}

添加后进入WordPress后台「设置」-「固定链接」页面，点击「保存更改」刷新重写规则。

额外优化建议 #

• 代码中循环调用外部API的逻辑会严重拖慢页面加载速度，建议使用wp_cache_set()和wp_cache_get()缓存API返回结果，避免每次请求都调用外部接口。
• 确保自定义文章类型company在注册时设置了has_archive参数，若无需归档页面可设为false，避免与页面模板的路由冲突。

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