基于ACF字段与自定义分类的Research Materials固定链接问题

看起来你的核心问题是WordPress优先匹配了artwork的 rewrite 规则，导致请求被解析成了artwork文章，而不是你期望的research-materials单页。咱们一步步来排查修复：

1. 先禁用Research Materials的默认Rewrite规则 #

在注册research-materials自定义文章类型时，默认的rewrite规则会和你自定义的URL结构冲突，先把它关掉：

public static function build_custom_post_types(){
    $labels = array(
        // 保持原labels不变
    );
    $args = array(
        'labels' => $labels,
        // ... 其他参数保持不变
        'rewrite' => false, // 禁用默认rewrite规则，避免冲突
    );
    register_post_type( 'research-materials', $args );
}

2. 添加正确的自定义Rewrite规则 #

你的目标URL结构是/artwork/{related-artwork-slug}/research-materials/{tax-term}/{research-slug}/，需要添加对应的rewrite规则，并且确保优先级高于artwork的默认规则（所以init钩子的优先级要设得比artwork注册的优先级高，比如设为9）：

public static function rewrite_stuff(){
    // 添加自定义rewrite规则，匹配目标URL结构
    add_rewrite_rule(
        '^artwork/([^/]+)/research-materials/([^/]+)/([^/]+)/?$',
        'index.php?post_type=research-materials&research_slug=$matches[3]&related_artwork_slug=$matches[1]&research_tax_term=$matches[2]',
        'top' // 设为top，确保优先匹配
    );
}

// 注意修改init钩子的优先级，确保在artwork注册之后、默认rewrite规则生成之前执行
add_action( 'init', 'RRP::rewrite_stuff', 9 );

3. 注册自定义Query变量 #

需要让WordPress识别我们在rewrite规则里用的自定义变量：

public static function build_query_vars( $vars ){
    $vars[] = 'related_artwork_slug';
    $vars[] = 'research_tax_term';
    $vars[] = 'research_slug';
    return $vars;
}

4. 修改查询逻辑，指向Research Materials #

在pre_get_posts里调整主查询，让WordPress根据自定义变量查询research-materials文章，而不是artwork：

public static function pre_get_posts( $query ){
    // 只处理前台主查询
    if( !is_admin() && $query->is_main_query() ){
        // 检查是否有research_slug变量，确认是访问research-materials单页
        if( isset( $query->query_vars['research_slug'] ) && $query->query_vars['post_type'] === 'research-materials' ){
            // 根据自定义字段research_materials_slug查询文章
            $query->set( 'meta_key', 'research_materials_slug' );
            $query->set( 'meta_value', $query->query_vars['research_slug'] );
            $query->set( 'meta_compare', '=' );
            
            // 可选：同时验证分类术语
            if( isset( $query->query_vars['research_tax_term'] ) ){
                $query->set( 'tax_query', array(
                    array(
                        'taxonomy' => 'research-material-type',
                        'field'    => 'slug',
                        'terms'    => $query->query_vars['research_tax_term'],
                    )
                ) );
            }
            
            // 确保只返回一篇文章
            $query->set( 'posts_per_page', 1 );
        }
    }
    return $query;
}

5. 生成正确的固定链接 #

需要过滤post_type_link来为research-materials文章生成符合要求的URL：

public static function generate_research_materials_permalink( $link, $post ){
    if( $post->post_type === 'research-materials' ){
        // 获取关联的artwork slug（假设你的ACF字段是related_artwork_slug）
        $related_artwork_slug = get_field( 'related_artwork_slug', $post->ID );
        // 获取分类术语slug
        $terms = get_the_terms( $post->ID, 'research-material-type' );
        $tax_term_slug = $terms ? $terms[0]->slug : '';
        // 获取自定义的research slug
        $research_slug = get_field( 'research_materials_slug', $post->ID );
        
        // 拼接成目标URL
        if( $related_artwork_slug && $tax_term_slug && $research_slug ){
            $link = home_url( "/artwork/{$related_artwork_slug}/research-materials/{$tax_term_slug}/{$research_slug}/" );
        }
    }
    return $link;
}
// 添加这个过滤器到init钩子里
add_action( 'init', function(){
    add_filter( 'post_type_link', 'RRP::generate_research_materials_permalink', 10, 2 );
} );

最后一步：刷新固定链接设置 #

做完以上修改后，一定要进入WordPress后台的设置→固定链接页面，不需要修改任何设置，直接点击「保存更改」，让WordPress刷新rewrite规则缓存。

额外注意点 #

• 确保你的ACF字段related_artwork_slug存储的是有效的artwork文章slug，避免无效URL
• 如果有多个分类术语，你可能需要调整分类术语的获取逻辑（比如取第一个或指定的术语）
• 测试时可以开启WP_DEBUG和WP_DEBUG_LOG，查看是否有查询错误日志

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