WordPress分页问题：paged/page查询变量始终为0

问题根源 #

WooCommerce我的账户页面属于单页模板，默认使用page查询变量而非paged；同时自定义端点默认不允许paged参数传递，加上分页链接的URL结构适配错误，导致分页功能失效。

分步解决方案 #

1. 允许自定义端点接收paged查询变量 #

将paged添加到WooCommerce的允许查询变量列表，确保WordPress能识别该参数：

add_filter( 'woocommerce_get_query_vars', 'allow_paged_on_library_endpoint' );
function allow_paged_on_library_endpoint( $query_vars ) {
    $query_vars['paged'] = 'paged';
    return $query_vars;
}

2. 正确获取分页页码 #

替换短代码中$paged的获取逻辑，直接从$_GET中安全读取参数，避免单页模板的变量冲突：

// 替换原有的$paged赋值代码
$paged = isset( $_GET['paged'] ) ? absint( $_GET['paged'] ) : 1;

3. 修正分页链接的URL结构 #

默认的get_pagenum_link无法适配WooCommerce账户端点的URL，需要手动构造分页链接的基础地址：

// 替换原有的paginate_links代码
$library_endpoint_url = wc_get_account_endpoint_url( 'library' );
$pagination_base = trailingslashit( $library_endpoint_url ) . '?paged=%#%';

echo '<div class="score-links">';
echo paginate_links( array(
    'base'      => $pagination_base,
    'total'     => $query->max_num_pages,
    'current'   => max( 1, $paged ),
    'format'    => '',
    'show_all'  => false,
    'type'      => 'plain',
) );
echo '</div>';

4. 额外优化（可选） #

循环内的get_posts调用建议改用WP_Query并重置，避免干扰主查询（虽然你说屏蔽后问题仍存在，但优化后更健壮）：

// 替换原有的$high_score = get_posts(...)代码
$high_score_query = new WP_Query(array(
    'post_type'      => 'scores', 
    'author'         => $current_user->ID, 
    'posts_per_page' => 1, 
    'order'          => 'DESC', 
    'meta_query'     => array(
        array(
            'key'   => 'game',
            'value' => get_the_ID()
        )
    )
));

if ( $high_score_query->have_posts() ) {
    $high_score_query->the_post();
    echo '<div>High Score: ' . esc_html( get_field('score') ) .'</div>';
    wp_reset_postdata();
}

验证操作 #

修改代码后，访问游戏库页面，点击分页链接，检查URL是否为my-account/library/?paged=2格式，且第二页能正确加载对应数量的游戏。

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