WordPress自定义文章与页面别名冲突问题：页面无法加载

核心原因 #

WordPress重写规则的优先级中，自定义文章类型的路由会优先匹配/blog/开头的请求，导致别名同为blog的页面被拦截，无法正常加载。

解决方案 #

1. 调整自定义文章类型注册参数 #

在注册blog类型的代码中，修改rewrite配置并禁用默认归档：

register_post_type( 'blog', array(
    'public' => true,
    'label' => '博客',
    'rewrite' => array(
        'slug' => 'blog',
        'with_front' => false,
        'pages' => true
    ),
    'has_archive' => false, // 禁用默认归档，避免与自定义页面冲突
    // 其他必要参数（如支持的功能、菜单位置等）
) );

2. 调整重写规则优先级 #

通过过滤器让页面/blog/的规则优先匹配，将以下代码添加到主题的functions.php：

function prioritize_blog_page_rule( $rules ) {
    $custom_rules = array();
    // 优先匹配/blog/路径，指向别名blog的页面
    $custom_rules['blog/?$'] = 'index.php?pagename=blog';
    // 合并原有规则，确保自定义文章类型的详情页规则仍生效
    return $custom_rules + $rules;
}
add_filter( 'rewrite_rules_array', 'prioritize_blog_page_rule' );

3. 刷新固定链接规则 #

登录WordPress后台，进入「设置」→「固定链接」，直接点击「保存更改」（无需修改现有设置），让系统重新生成.htaccess规则。

4. 验证自定义页面模板 #

确保page-blog.php模板位于主题根目录，且头部模板声明正确：

<?php
/*
Template Name: 博客归档页面
*/
get_header();

// 博客列表循环逻辑示例
$blog_query = new WP_Query( array(
    'post_type' => 'blog',
    'posts_per_page' => 10
) );
if ( $blog_query->have_posts() ) :
    while ( $blog_query->have_posts() ) : $blog_query->the_post();
        the_title( '<h2><a href="' . get_permalink() . '">', '</a></h2>' );
        the_excerpt();
    endwhile;
    wp_reset_postdata();
endif;

get_footer();
?>

在后台编辑别名blog的页面时，选择该模板（页面属性→模板）。

完成以上步骤后，example.com/blog/（自定义归档页面）和example.com/blog/%postname%/（单篇博客详情页）即可正常访问。

内容的提问来源于stack exchange，提问作者Krishnendu Saha