在ACF区块中使用WP_Query无法获取自定义字段数据的问题

核心原因：get_field() 默认上下文错误 #

在ACF区块模板里，get_field() 默认会读取当前区块所在页面/帖子的ID，而非你WP_Query循环中services文章的ID。普通模板的WP_Query循环通常会自动更新全局$post对象，ACF能自动识别这个上下文，但区块模板的环境特殊，全局$post仍指向区块所属的页面，导致自定义字段取值错位。

具体解决步骤 #

1. 在循环中明确传递文章ID给get_field() #

在WP_Query循环内调用get_field()时，必须传入当前services文章的ID作为第二个参数，示例代码：

$popular_services = new WP_Query(array(
    'post_type' => 'services',
    'posts_per_page' => 6,
    // 补充你的热门服务筛选逻辑，比如按自定义排序字段或浏览量排序
));

if ($popular_services->have_posts()) :
    while ($popular_services->have_posts()) : $popular_services->the_post();
        // 获取当前服务文章的ID
        $service_id = get_the_ID();
        
        // 明确传入ID获取自定义字段
        $search_image = get_field('search_image', $service_id);
        $search_description = get_field('search_description', $service_id);
        
        // 输出内容示例
        if ($search_image) {
            echo wp_get_attachment_image($search_image['ID'], 'medium');
        }
        echo '<h3><a href="' . get_permalink() . '">' . get_the_title() . '</a></h3>';
        if ($search_description) {
            echo '<p>' . $search_description . '</p>';
        }
    endwhile;
    wp_reset_postdata();
endif;

2. 检查自定义字段组的分配规则 #

进入ACF后台的字段组设置，确认「Search Image」和「Search Description」的位置规则已设置为「Post Type is equal to Services」。如果规则错误，字段不会关联到services自定义文章类型，自然无法取出值。

3. 验证WP_Query的查询结果 #

可以在循环内临时输出get_the_ID()和var_dump(get_post_type())，确认循环中的文章确实是services类型，避免因查询参数错误（比如post_type拼写错误、筛选条件导致无结果）出现字段为空的情况。

额外注意事项 #

• 区块中使用WP_Query后，务必调用wp_reset_postdata()，避免破坏全局$post对象，影响后续内容输出。
• 如果使用the_field()直接输出，同样需要传入文章ID作为第二个参数，比如the_field('search_description', $service_id)。

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