WordPress ACF自定义块中自定义文章类型字段数据无法加载

你遇到的核心问题是ACF自定义块上下文里，自定义文章类型的ACF字段无法加载，但常规文章正常，且非块环境下循环逻辑可用。从代码来看，主要有两个关键问题导致：

1. WP_Query实例变量名冲突 #

你在render.php中把WP_Query实例赋值给了$post变量：

$post = new WP_Query( array(
    'post_type' => $cpt,
    'posts_per_page' => 1 
) );

而$post是WordPress的全局变量，用于存储当前帖子对象。这个赋值会覆盖全局$post，导致后续the_post()执行后，模板中调用$post->ID时可能指向WP_Query实例而非目标帖子对象，进而使get_field()无法正确获取字段值。

2. wp_reset_postdata()位置错误 #

当前代码将wp_reset_postdata()放在了while循环内部：

while ( $post->have_posts() ) : $post->the_post();
    // 模板引入
    wp_reset_postdata();
endwhile;

wp_reset_postdata()的作用是恢复全局$post为原始状态，放在循环内会导致每次迭代后就重置上下文，后续模板中的字段获取会丢失当前帖子的上下文。

步骤1：修改WP_Query变量名 #

将查询实例的变量名从$post改为不冲突的名称（比如$custom_query），避免覆盖全局变量：

// 替换原WP_Query代码
$custom_query = new WP_Query( array(
    'post_type' => $cpt,
    'posts_per_page' => 1 
) );

// 后续循环条件和the_post()也对应修改
if ( $custom_query->have_posts() ) :
    while ( $custom_query->have_posts() ) : $custom_query->the_post();
        // 模板引入逻辑不变
    endwhile;
    // 把wp_reset_postdata()移到这里
    wp_reset_postdata();
endif;

wp_reset_query();

步骤2：调整wp_reset_postdata()位置 #

将wp_reset_postdata()移到while循环结束后、endif之前，确保整个循环执行完毕后再恢复全局上下文。

步骤3：优化模板中的字段获取（可选但推荐） #

在自定义文章类型的循环模板中，尽量使用get_the_ID()代替$post->ID，因为the_post()执行后，get_the_ID()能可靠返回当前帖子的ID，避免变量冲突问题：

// 替换模板中的$post->ID为get_the_ID()
$rn_title = get_the_title( get_the_ID() );
$rn_date = get_field('rn_date', get_the_ID());
$rn_link = get_permalink(get_the_ID());
$rn_introduction= get_field('rn_introduction' , get_the_ID());
$rn_banner = get_field('rn_banner', get_the_ID());
$rn_thumbnail_image = get_field('rn_thumbnail_image', get_the_ID());

$theme = get_stylesheet_directory();
$loop_templates = $theme . '/loop-templates/';

$post_type = get_field('post_type');

switch ($post_type) {
    case 'Podcast':
        $cpt = 'podcasts';
        break;
    case 'Newsletter':
        $cpt = 'newsletters';
        break;
    case 'Blog Post':
        $cpt = 'post';
        break;
    case 'Download':
        $cpt = 'downloads';
        break;
    case 'Video':
        $cpt = 'videos';
        break;
    default:
        $cpt = 'post';
}

$choose_post = get_field('choose_post');

if($choose_post == 'most recent'){
  
    // 修改变量名为$custom_query，避免覆盖全局$post
    $custom_query = new WP_Query( array(
        'post_type' => $cpt,
        'posts_per_page' => 1 
    ) );
      
    if ( $custom_query->have_posts() ) :
        while ( $custom_query->have_posts() ) : $custom_query->the_post();
       
            if($post_type == 'Podcast'):
                include($loop_templates.'content-podcast.php');
            elseif($post_type == 'Newsletter'):
                include($loop_templates.'content-newsletter.php');
            elseif($post_type == 'Blog Post'):  
                include($loop_templates.'content-post.php');
            elseif($post_type == 'Download'):
                include($loop_templates.'content-download.php');
            elseif($post_type == 'Video'):
                include($loop_templates.'content-video.php');
            endif;

        endwhile;
        // 移到循环结束后执行
        wp_reset_postdata();
    endif;

    wp_reset_query();

}

如果修复后仍有问题，可以检查：

• 自定义文章类型的ACF字段是否正确关联到对应的文章类型（在ACF字段组的“位置”设置中确认）；
• 确保目标自定义文章确实填写了ACF字段数据；
• 禁用其他插件，排除插件冲突影响ACF字段的加载。

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