在pre_get_posts钩子中使用switch_to_blog致动作/过滤器失效求助

问题根源 #

你在pre_get_posts钩子中直接切换博客上下文的做法，会导致后续所有WordPress钩子（动作/过滤器）都在主站点（ID=1）的环境下执行，原站点的钩子绑定自然失效。而且get_posts动作的触发时机和主查询的生命周期不匹配，无法保证restore_current_blog()能在正确节点恢复原上下文。

推荐解决方案 #

方案1：直接跨站获取文章（不修改主查询）

这种方式无需切换全局博客上下文，仅在模板中针对性获取主站点的文章数据，对现有钩子体系无影响。

在你的single-lesson.php模板中替换原有渲染逻辑：

global $post;
$current_blog_id = get_current_blog_id();
$target_blog_id = 1; // 主站点ID

// 非主站点时，跨站获取lesson数据
if ($current_blog_id !== $target_blog_id && is_singular('lesson')) {
    $cross_post = get_blog_post($target_blog_id, get_queried_object_id());
    
    if ($cross_post) {
        // 临时替换全局post对象并初始化
        $temp_post = $post;
        $post = $cross_post;
        setup_postdata($post);

        // 渲染文章内容（保留原模板的标题、内容、自定义字段逻辑）
        the_title('<h1 class="entry-title">', '</h1>');
        the_content();
        // 示例：获取跨站点自定义字段
        echo get_post_meta($post->ID, 'lesson_duration', true, $target_blog_id);

        // 恢复原post对象
        $post = $temp_post;
        wp_reset_postdata();
    } else {
        // 处理文章不存在的情况
        get_template_part('404');
    }
} else {
    // 主站点正常渲染原有内容
    get_template_part('content', 'lesson');
}

方案2：安全修改主查询（控制上下文切换范围）

如果必须通过修改主查询实现，要严格控制上下文切换的生命周期，确保在主查询完成后立即恢复原站点：

function adjust_lesson_query_for_multisite($query) {
    // 仅针对前端单lesson主查询，且非主站点
    if (!is_admin() && $query->is_main_query() && $query->is_singular('lesson') && get_current_blog_id() !== 1) {
        switch_to_blog(1);
        // 在主查询完成后（wp钩子触发时）立即恢复原站点，设最高优先级确保最后执行
        add_action('wp', function() {
            restore_current_blog();
        }, PHP_INT_MAX);
    }
}
add_action('pre_get_posts', 'adjust_lesson_query_for_multisite');

关键注意事项 #

• 确保自定义文章类型lesson在两个站点都完成注册，否则非主站点无法识别该类型的查询规则。
• 跨站点获取自定义字段时，可直接使用get_post_meta()的第四个参数指定目标博客ID，无需切换上下文：get_post_meta($post_id, $meta_key, $single, $blog_id)。
• 避免在全局钩子中长时间持有切换后的博客上下文，尽可能缩小切换范围，减少对其他功能的影响。

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