WordPress自定义文章类型归档页面分页失效问题排查

数据老陈

2026-8-7

解决WordPress自定义文章类型归档分页失效问题

你的核心问题出在paginate_links函数的base参数配置错误，导致分页链接无法正确传递paged参数到自定义查询中。wp_reset_postdata()的位置是正确的，之前把分页代码放在它前面导致每篇文章旁都出现分页，是因为代码被包含在了循环体内。

具体修正方案：

1. 修复`paginate_links`的`base`参数

你当前用get_pagenum_link(1) . '%_%'作为base，会导致分页链接结构错误，无法正确识别页码参数。推荐使用WordPress原生的通用写法，自动适配当前页面的URL结构：

'base' => str_replace(999999999, '%#%', esc_url(get_pagenum_link(999999999))),

2. 关联自定义查询的当前页码

直接使用自定义查询对象的get('paged')属性获取当前页码，避免全局变量冲突：

'current' => $villagelifeArchive->get('paged') ? $villagelifeArchive->get('paged') : 1,

完整修正后的分页代码

替换你原有的分页代码块为：

$total_pages = $villagelifeArchive->max_num_pages;

if ( $total_pages > 1 ) {
    ?>
    <div class="pagination">
    <?php
    echo paginate_links(
        array(
            'base'      => str_replace(999999999, '%#%', esc_url(get_pagenum_link(999999999))),
            'format'    => get_option('permalink_structure') ? '/page/%#%' : '?paged=%#%',
            'current'   => $villagelifeArchive->get('paged') ? $villagelifeArchive->get('paged') : 1,
            'total'     => $total_pages,
            'prev_text' => __('« 上一页'),
            'next_text' => __('下一页 »'),
        )
    );
    ?>
    </div>
    <?php
}