WordPress静态首页front-page.php分页失效问题求助

已将WordPress设置为静态首页（使用front-page.php模板），文章页index.php的分页功能正常，但在首页添加的自定义文章展示区块点击分页按钮后，URL页码变化但文章内容不更新。

原因分析 #

1. 自定义WP_Query未读取URL中的分页参数（paged），导致每次查询都返回第一页数据。
2. 默认的the_posts_pagination()函数基于WordPress主查询（首页主查询是静态页，无分页数据），无法适配自定义查询的分页逻辑。

解决步骤 #

• 在自定义查询参数中添加paged参数，获取当前页码。
• 使用自定义WP_Query对象的the_posts_pagination()方法，而非全局函数。

修改后的front-page.php代码 #

<?php
get_header();
get_template_part('template-parts/content', 'home');
?>

<div class="container-worksheets" style="padding-top: 0;">
    <div class="cards-container" style="padding-top: 0;">
        <?php
        // 获取当前页码：静态首页可能使用page参数，兼容处理
        $paged = (get_query_var('paged')) ? get_query_var('paged') : ((get_query_var('page')) ? get_query_var('page') : 1);
        
        // 定义查询参数，添加paged参数
        $args = array(
            'post_type' => 'post',
            'posts_per_page' => 4,
            'orderby' => 'date',
            'order' => 'DESC',
            'paged' => $paged // 关键：传入当前页码
        );

        $query = new WP_Query($args);

        if ($query->have_posts()) {
            while ($query->have_posts()) {
                $query->the_post();
        ?>
                <a href="<?php echo get_permalink(); ?>">
                    <div class="card-items">
                        <div class="img-holder">
                            <img src="<?php echo get_the_post_thumbnail_url(); ?>" alt="featured image">
                        </div>
                        <div class="info">
                            <p><?php echo get_the_title(); ?></p>
                            <div class="hide">
                                <p><?php echo substr(get_the_content(), 0, 100); ?></p>
                                <span><?php echo get_the_category()[0]->name; ?></span>
                            </div>
                            <span>workshhets</span>
                        </div>
                    </div>
                </a>
        <?php
            }

            // 使用自定义查询对象的分页方法
            $query->the_posts_pagination(array(
                'mid_size' => 2,
                'prev_text' => __('上一页', 'textdomain'),
                'next_text' => __('下一页', 'textdomain'),
            ));

            wp_reset_postdata();
        } else {
            echo '<p>No posts found.</p>';
        }
        ?>
    </div>
</div>

<?php get_footer(); ?>

关键改动说明 #

1. 获取分页参数：通过get_query_var()获取paged或page参数，兼容静态首页的分页参数传递逻辑。
2. 添加paged到查询参数：让自定义查询根据当前页码返回对应的数据页。
3. 调用自定义查询的分页方法：$query->the_posts_pagination()确保分页逻辑基于当前自定义查询，而非首页的主查询。

注意事项 #

• 如果主题有自定义分页样式，可调整the_posts_pagination()的参数（如mid_size、prev_text等）适配主题风格。
• 确保wp_reset_postdata()在分页输出之后调用，避免影响后续模板的主查询使用。

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