WordPress替换Permalink中CPT为自定义分类并避免404错误的方法

问题根源 #

你当前的代码仅修改了文章链接的显示格式，但未同步更新WordPress的重写规则以匹配新URL结构；同时pre_get_posts的逻辑仍适配「直接移除CPT slug」的场景，不兼容「分类+文章名」的新路径，另外也未处理文章未分配分类的异常情况，这些共同导致了404错误。

分步解决方法 #

1. 修复文章链接生成的异常处理 #

先修改remove_cpt_slug函数，添加分类不存在时的兜底逻辑，避免报错中断：

function remove_cpt_slug( $post_link, $post ) {
    if ( 'custom-post-type-name' === $post->post_type && 'publish' === $post->post_status ) {
        // 获取文章关联的分类，增加错误判断
        $post_terms = get_the_terms( $post->ID, 'custom-post-type-name-category' );
        if ( $post_terms && ! is_wp_error( $post_terms ) ) {
            $category_slug = $post_terms[0]->slug;
            $post_link = str_replace( '/' . $post->post_type . '/', '/' . $category_slug . '/', $post_link );
        } else {
            // 无分类时的兜底路径，可根据需求修改
            $post_link = str_replace( '/' . $post->post_type . '/', '/uncategorized/', $post_link );
        }
    }
    return $post_link;
}
add_filter( 'post_type_link', 'remove_cpt_slug', 10, 2 );

2. 更新重写规则，让WordPress识别新URL结构 #

需要添加自定义重写规则，同时确保CPT的注册参数配置正确：

第一步：检查CPT注册代码

确保注册CPT时，rewrite参数设置正确，避免和新路径冲突：

register_post_type( 'custom-post-type-name', array(
    // 其他参数（如标签、支持功能等）...
    'rewrite' => array( 'slug' => 'custom-post-type-name', 'with_front' => false ),
) );

第二步：添加自定义重写规则

注册新规则，告诉WordPress如何解析「分类slug/文章名」的URL：

function custom_cpt_rewrite_rules() {
    add_rewrite_rule(
        '^([^/]+)/([^/]+)/?$',
        'index.php?custom-post-type-name-category=$matches[1]&name=$matches[2]&post_type=custom-post-type-name',
        'top'
    );
}
add_action( 'init', 'custom_cpt_rewrite_rules' );

3. 修改pre_get_posts逻辑适配新结构 #

原函数逻辑针对「无CPT slug直接访问文章名」的场景，现在调整为匹配「分类+文章名」的URL结构：

function add_cpt_post_names_to_main_query( $query ) {
    // 仅处理前台主查询，排除后台和自定义查询
    if ( is_admin() || ! $query->is_main_query() ) {
        return;
    }

    // 匹配分类+文章名的URL参数
    if ( isset( $query->query['custom-post-type-name-category'] ) && isset( $query->query['name'] ) ) {
        // 指定查询目标CPT类型
        $query->set( 'post_type', 'custom-post-type-name' );
        // 增加分类匹配条件，确保结果精准
        $query->set( 'tax_query', array(
            array(
                'taxonomy' => 'custom-post-type-name-category',
                'field'    => 'slug',
                'terms'    => $query->query['custom-post-type-name-category'],
            )
        ) );
    }
}
add_action( 'pre_get_posts', 'add_cpt_post_names_to_main_query' );

4. 刷新重写规则 #

完成以上修改后，必须刷新WordPress的重写规则才能生效：

• 登录后台，进入「设置」→「固定链接」
• 无需修改任何设置，直接点击「保存更改」按钮，系统会自动生成新的重写规则。

额外注意事项 #

• 确保自定义分类custom-post-type-name-category的slug不与页面、文章、其他CPT的slug重复，否则会引发路径冲突。
• 若同一文章名出现在不同分类下，WordPress会返回第一个匹配结果，建议确保文章名全局唯一，或在重写规则中增加更严格的匹配逻辑。

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