WordPress自定义主题jobs类型文章分页多页访问报404错误求助

核心代码错误修正 #

首先你当前代码里存在一处直接导致分页失效的参数传值错误：

• 你已经提前获取到了当前页号存入$paged变量，但给WP_Query传分页参数时，错误地把字符串'paged'作为参数值传入，没有使用实际获取的页号变量，导致查询逻辑完全不识别当前分页位置。
• 错误写法：'paged' => 'paged'
• 正确写法：'paged' => $paged

修正后的查询段代码参考：

// 获取当前分页号
$paged = ( get_query_var( 'paged' ) ) ? get_query_var( 'paged' ) : 1;

$args = array(
    'orderby' => 'date',
    'post_type' => 'jobs',
    'posts_per_page' => 1,
    // 传入实际页号变量
    'paged' => $paged
);
$the_query = new WP_Query( $args );

404问题的根因解决 #

就算修正查询参数，自定义文章类型的分页仍可能触发404，这是WordPress重写规则缓存不匹配、分页路径生成错误导致的，按以下步骤处理即可：

• 检查jobs自定义文章类型的注册配置，确保has_archive参数设置为true（匹配jobs列表页的访问路径），同时在rewrite配置中明确分页路径规则，示例配置：'rewrite' => ['slug' => 'jobs', 'with_front' => false]
• 如果你的jobs列表不是放在默认的archive-jobs.php归档模板中，而是放在自定义页面模板（如page-jobs.php）中，需要手动给paginate_links指定正确的分页base路径，不然自动生成的链接会指向首页分页地址，和实际页面路径不匹配导致404。示例：当列表页实际路径为/recruitment/jobs/时，base参数设置为trailingslashit(home_url('/recruitment/jobs')) . 'page/%#%/'
• 完成所有代码修改后，进入WordPress后台「设置-固定链接」页面，不需要修改任何配置项，直接点击页面底部的「保存更改」，强制刷新重写规则缓存，绝大多数自定义文章类型分页404的问题都能通过这一步解决。

冗余代码清理与长期优化 #

你当前的分页代码段中存在一处不影响运行的冗余逻辑：定义的$current_page变量在后续分页输出时完全没有被调用，可以直接删除。

更稳妥的长期方案：如果当前jobs列表页使用的是WordPress默认归档模板（archive-jobs.php），不建议在模板中通过独立WP_Query覆盖主查询。可以通过pre_get_posts钩子调整主查询参数，让分页逻辑完全适配WordPress原生重写规则，从根源避免404问题，钩子代码参考：

// 调整jobs归档页的主查询参数
add_action('pre_get_posts', 'custom_jobs_archive_query');
function custom_jobs_archive_query($query) {
    // 跳过后台请求、非主查询、非jobs归档页的场景
    if (is_admin() || !$query->is_main_query() || !is_post_type_archive('jobs')) {
        return;
    }
    // 设置每页展示数量为1
    $query->set('posts_per_page', 1);
    // 保持按发布时间排序
    $query->set('orderby', 'date');
}

这种方案下，模板里的分页代码可以直接使用原生逻辑生成链接，不需要额外配置base路径，和系统自带的分页规则完全兼容。

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