wp_link_pages()链接显示但点击后无法切换页面问题求助

我来帮你排查这个分页失效的问题，这是WordPress里挺常见的小坑，咱们一步步来定位原因：

1. 确认wp_link_pages()的调用位置和参数是否正确 #

首先要确保wp_link_pages()是在主循环内部、the_content()输出之后调用的，而且参数配置没问题。比如你的index.php里应该是这样的结构：

<?php if ( have_posts() ) : ?>
    <?php while ( have_posts() ) : the_post(); ?>
        <!-- 输出文章标题等内容 -->
        <?php the_content(); ?>
        <!-- 分页链接要放在the_content之后 -->
        <?php wp_link_pages( array(
            'before'      => '<div class="page-links">Pages:',
            'after'       => '</div>',
            'link_before' => '<span>',
            'link_after'  => '</span>',
            'pagelink'    => '%',
        ) ); ?>
    <?php endwhile; ?>
<?php endif; ?>

如果你的分页代码放在了循环外面，或者the_content()之前，就会导致分页逻辑不生效。

2. 检查文章内容的分页分隔符是否正确 #

Gutenberg的分页块本质是生成<!--nextpage-->注释来分隔内容，你可以切换到文章的代码编辑器（右上角三个点->代码编辑器），确认内容里确实有这个注释把内容分成了多段。如果分隔符缺失或者格式错误，WordPress就识别不到分页。

3. 刷新固定链接的Rewrite规则 #

有时候固定链接配置会导致分页的URL解析异常。你可以进入后台的设置->固定链接，随便选择一个不同的链接结构（比如“朴素”）保存，然后再切回你原来的配置保存一次，这样就能刷新Rewrite规则，修复可能的URL路由问题。

4. 排查插件或主题的干扰 #

很多时候是插件（比如缓存插件、SEO插件）或者主题的自定义代码破坏了分页逻辑：

• 先暂时禁用所有插件，测试分页是否正常；如果恢复正常，再逐个启用插件，找到导致问题的那个。
• 切换到WordPress默认主题（比如Twenty Twenty-One）测试，如果分页正常，说明是你当前主题的代码有问题，需要检查主题的functions.php或者模板文件里是否有修改pre_get_posts、query_vars的代码，或者自定义查询时没处理分页参数。

5. 检查自定义查询的分页参数（如果有的话） #

如果你的index.php里用了new WP_Query()做自定义查询，一定要记得传递paged参数，否则分页会失效：

// 获取当前分页页码
$paged = ( get_query_var( 'paged' ) ) ? get_query_var( 'paged' ) : 1;
// 构建查询参数
$custom_query_args = array(
    'paged' => $paged,
    // 其他查询条件，比如分类、数量等
);
$custom_query = new WP_Query( $custom_query_args );

// 循环输出内容
if ( $custom_query->have_posts() ) :
    while ( $custom_query->have_posts() ) : $custom_query->the_post();
        the_content();
        wp_link_pages();
    endwhile;
    // 重置查询
    wp_reset_postdata();
endif;

如果自定义查询没加paged参数，不管点击哪个分页，都会显示第一页的内容。

6. 检查服务器/CDN缓存 #

如果你的网站用了CDN或者服务器端缓存（比如Nginx缓存、WP Rocket这类插件缓存），可能会把第一页的内容缓存下来，导致点击分页后还是显示缓存的第一页。可以暂时关闭缓存功能测试，确认是否是缓存导致的问题，如果是，需要配置缓存规则排除分页页面。

先从上面这几个步骤排查，应该能解决大部分分页不切换的问题~

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