ACF区块内传入post ID调用have_rows无法获取跨页数据问题

问题场景 #

使用ACF创建Gutenberg区块时，通过指定页面ID拉取其他页面的repeater字段数据无法正常展示，已验证获取到的目标页面ID值正确，同一段代码移除ID传参、在字段所属原页面运行可正常输出，仅传入ID参数时无内容。
原有实现代码：

$page_id = get_field('registration_page');

if(have_rows('form_steps', $page_id)) :
    echo '<div class="form-steps">';
        echo '<div class="step-line"></div>';
        echo '<div class="step-fill" style="width:900px;"></div>';
        while(have_rows('form_steps', $page_id)) : the_row();
            echo '<div class="step confirmed">';
                echo '<div class="icon"><img src="'.get_sub_field('icon').'" /></div>';
                echo '<div class="step-label">'.get_sub_field('label').'</div>';
            echo '</div>';
        endwhile;
    echo'</div>';
endif;

故障原因与对应修复 #

• ID类型/格式不匹配
  Gutenberg区块渲染上下文下，页面选择类字段返回的ID可能是字符串类型、或带page_前缀的格式，即使echo输出看起来是数字，类型不匹配也会导致have_rows()无法正确识别目标页面。修复时直接对ID做强转整数处理：$page_id = (int)get_field('registration_page');
• ACF循环指针残留
  Gutenberg页面中如果存在多个ACF区块，前序区块的ACF循环未正常退出会留下全局指针缓存，跨页面调用repeater时会直接读取失败。在调用have_rows()前先执行acf_reset_loop();清空内部循环状态即可。
• 同名字段键冲突
  如果当前渲染的页面本身也存在名为form_steps的字段，ACF会优先匹配当前页面的字段键，忽略传入的页面ID参数。此时将have_rows()、get_sub_field()中使用的字段名替换为ACF后台生成的唯一字段键（格式为field_xxxxxx）即可避免冲突。
• 子字段读取上下文偏移
  部分ACF版本下，跨页面循环repeater时，the_row()不会自动切换子字段读取的目标上下文，可在get_sub_field()调用时追加第二个参数$page_id明确指定读取来源。

修复后完整代码 #

// 强制转换ID为整数类型，排除格式问题
$page_id = (int)get_field('registration_page');
// 重置ACF循环状态，清除残留缓存
acf_reset_loop();

if(have_rows('form_steps', $page_id)) :
    echo '<div class="form-steps">';
        echo '<div class="step-line"></div>';
        echo '<div class="step-fill" style="width:900px;"></div>';
        while(have_rows('form_steps', $page_id)) : the_row();
            echo '<div class="step confirmed">';
                $icon = get_sub_field('icon', $page_id);
                $label = get_sub_field('label', $page_id);
                echo '<div class="icon"><img src="'.$icon.'" /></div>';
                echo '<div class="step-label">'.$label.'</div>';
            echo '</div>';
        endwhile;
    echo '</div>';
endif;

快速排查方法 #

若调整后仍不生效，可在判断逻辑前加var_dump(get_field('form_steps', $page_id));打印目标页面repeater的原始值：

• 能打印出结构化数组：说明数据读取正常，问题出在循环上下文或字段匹配逻辑
• 打印结果为false：检查目标页面状态（是否为草稿/待审核/被权限插件拦截）、ID是否正确、字段名/键是否拼写错误

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