WordPress嵌套查询异常：广告自定义文章类型被主循环重复渲染

问题情况 #

在主文章（post类型）循环的第2篇文章后插入广告卡片（自定义post type为ads），广告加载正常，但主查询后续会错误渲染该广告文章的卡片。

问题原因 #

主循环代码中错误地将wp_reset_postdata()放在了while循环内部，每次循环都会重置全局文章对象上下文。当子查询执行wp_reset_postdata()恢复主查询状态后，主循环再次调用该函数，会破坏当前主查询的遍历状态，导致后续循环时错误获取到子查询中的ads类型文章。

修复方案 #

将主循环中的wp_reset_postdata()移到整个while循环的外部，确保主查询遍历完成后再重置全局上下文；子查询中的wp_reset_postdata()保持不变，用于恢复主查询的上下文。

修改后的主查询代码 #

<?php 

//query to load selected featured post on front page
$postsPerPage = 12;
$args = array(
    'post_type' => 'post',
    'posts_per_page' => $postsPerPage,
);

$blogPostQuery = new WP_Query($args);

$i = 1;
while($blogPostQuery->have_posts()){
    $blogPostQuery->the_post(); 
    
    if($i == 3) {
     get_template_part('partials/ads', 'post'); 
    }
    
    ?>

    <?php $post_id = get_the_ID(); ?>

    <div class="blogCardBlackOverlay post-<?php echo $post_id; ?>">
        <div class="col-span-1 shadow-2xl">
            <?php echo $i; ?>
        <?php 
            $thumb = get_the_post_thumbnail_url(); 
            
        ?>
            <div class="relative blogPostCard rounded-xl" style="background-image: linear-gradient(rgba(66,32,6,0.7) 0%, rgb(134, 191, 255,0.3) 130%), url('<?php echo $thumb;?>')">
            <h1 class="blogPostCard_title font-sans text-white font-bold text-start"><?php the_title(); ?></h1>
            <!-- Gettng custom taxonomies associate with teh post -->
            <?php
                $terms = get_the_terms($post_id, 'acquisition');

                if ($terms && !is_wp_error($terms)) {
                    $first_term = reset($terms); ?>
                    <span class="blogCard_taxonomy__item py-1 px-4 text-sm rounded-2xl absolute bottom-4 right-4 font-medium item-<?php echo $first_term->slug; ?>"><?php echo $first_term->name; ?></span>
                <?php
                }
            ?>
            <!-- Reading time -->
            <div class="blogPost_readingTime__wrapper">
                <?php 
                $readingTime = get_field('reading_time');
                ?>
                <div class="blogPost_readingTime text-white text-avenir absolute bottom-4 left-4">
                    <i class="fa-regular fa-lightbulb"></i>
                    <span><?php echo $readingTime; ?></span>
                </div>
            </div>
            <a href="#" type="button" class="view-post" data-postid="<?php the_ID(); ?>" data-slug="<?php echo get_post_field('post_name', $post_id); ?>"></a>
            </div>
        </div>
    </div>
<?php
$i++;
}
// 将wp_reset_postdata()移到循环外部，仅在主查询遍历完成后执行一次
wp_reset_postdata();
?>

补充说明 #

• wp_reset_postdata()的作用是恢复全局$wp_query的文章对象上下文，自定义查询（如主循环的$blogPostQuery）只需要在整个循环结束后调用一次即可。
• 子查询中的wp_reset_postdata()是正确的，它会在广告循环结束后恢复到主查询的当前文章状态，避免影响主循环的后续遍历。

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