WordPress自定义文章类型单页分页本地正常线上失效求助

针对你遇到的single-writer.php分页本地正常、线上点击后跳回原页面的问题，按以下步骤排查修复：

• 刷新固定链接规则
  线上服务器的重写规则可能未自动更新，导致分页URL无法被正确解析。进入WP后台「设置-固定链接」，临时切换到其他规则保存，再切回原有设置重新保存，强制刷新重写规则。

• 修正$paged变量获取逻辑
  自定义文章类型单页中，分页参数可能被识别为page而非paged，替换原有$paged的使用逻辑：

global $paged;
$paged = get_query_var('paged') ?: get_query_var('page') ?: 1;

确保无论参数是paged还是page，都能正确获取当前页码。

• 检查自定义文章类型注册配置
  注册writer类型时，确认rewrite参数开启分页支持：

register_post_type('writer', array(
    // 其他配置项...
    'rewrite' => array(
        'slug' => 'writer',
        'with_front' => false,
        'pages' => true, // 明确允许分页URL
    ),
));

修改后记得重新刷新固定链接。

• 验证服务器重写模块状态

  • Apache环境：确保mod_rewrite已启用，且根目录.htaccess包含正确的WP重写规则：

    # BEGIN WordPress
    <IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /
    RewriteRule ^index\.php$ - [L]
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule . /index.php [L]
    </IfModule>
    # END WordPress
    

  • Nginx环境：在站点配置中添加重写规则，确保所有请求转发到index.php：

    location / {
        try_files $uri $uri/ /index.php?$args;
    }
    

• 优化paginate_links参数
  指定分页链接的格式和基础URL，避免生成错误路径：

echo paginate_links(array(
    'current' => $paged,
    'total' => $posts->max_num_pages,
    'end_size' => 2,
    'prev_next' => true,
    'prev_text' => '<span class="previous">previous</span>',
    'next_text' => '<span>next</span>',
    'format' => 'page/%#%/',
    'base' => trailingslashit(get_permalink()) . '%_%'
));

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