WordPress自定义文章类型project分页失效问题求助

问题根源 #

WordPress全局「博客页面至多显示」的设置会默认覆盖所有查询的分页逻辑，同时自定义文章类型的分页路由（如/project/page/2/）需要正确的重写规则支撑，否则会触发404错误。

具体解决方案 #

1. 确保自定义文章类型注册时的重写规则配置 #

注册project类型时，必须开启归档支持并设置正确的重写参数，之后刷新固定链接：

function register_project_cpt() {
    $args = array(
        'public' => true,
        'label'  => 'Projects',
        'has_archive' => true,
        'rewrite' => array('slug' => 'project', 'with_front' => false),
        // 其他自定义参数（如支持的功能、分类法等）
    );
    register_post_type( 'project', $args );
}
add_action( 'init', 'register_project_cpt' );

操作提示：修改代码后，进入「设置>固定链接」页面，点击「保存更改」刷新重写规则，无需修改现有结构。

2. 用钩子强制覆盖全局分页设置 #

通过pre_get_posts钩子修改主查询，给project归档页单独设置每页显示数量，不受全局设置影响：

function set_project_posts_per_page( $query ) {
    if ( !is_admin() && $query->is_main_query() && is_post_type_archive( 'project' ) ) {
        $query->set( 'posts_per_page', 3 );
        // 确保分页参数正确传递
        $query->set( 'paged', get_query_var( 'paged', 1 ) );
    }
}
add_action( 'pre_get_posts', 'set_project_posts_per_page' );

注意：如果用Elementor自定义归档模板，需确保Elementor查询设置里的「每页项目数」也设为3，钩子会进一步强制覆盖全局配置。

3. 手动生成分页链接的正确写法 #

如果是自己写循环生成项目列表，使用paginate_links时要匹配自定义查询的参数：

$paged = get_query_var( 'paged', 1 );
$project_query = new WP_Query( array(
    'post_type' => 'project',
    'posts_per_page' => 3,
    'paged' => $paged
) );

// 输出分页
echo paginate_links( array(
    'base' => str_replace( 999999999, '%#%', esc_url( get_pagenum_link( 999999999 ) ) ),
    'format' => '?paged=%#%',
    'current' => $paged,
    'total' => $project_query->max_num_pages,
    'type' => 'list'
) );

wp_reset_postdata();

4. 404错误额外排查点 #

• 固定链接避免使用「朴素」结构，推荐用「文章名」或自定义结构；
• 临时禁用缓存、SEO类插件，排查是否有重写规则冲突；
• 确认Elementor模板的「分页」控件已启用，且查询逻辑未被其他自定义代码干扰。

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