ACF双向多对多关联字段在WordPress短代码中无返回值问题

算力阿峰

2026-6-28

问题

我创建了两个自定义文章类型（custom post types）：guest和video，通过ACF的关联字段rel_guest_video建立了**多对多双向（BIDIRECTIONAL）**关系，已确认双向关联配置正确（两个类型的关联字段slug相同）且功能正常，但编写的短代码无法获取关联数据。

为测试我硬编码了一个已知存在且应关联两位guest的video_id，但短代码一直返回“No related guests found”提示，调试$related_guests时无任何内容输出。请问是否是双向关联特性导致该问题？

以下是短代码代码：

// Register the shortcode
add_shortcode('related_guest_info', 'related_guest_info_shortcode');

// Define the shortcode function
function related_guest_info_shortcode($atts) {
    // Extract shortcode attributes
    $atts = shortcode_atts(array(
        'video_id' => 12834, // Default value
    ), $atts, 'related_guest_info');

    // Ensure video_id is set and numeric
    if (!empty($atts['video_id']) && is_numeric($atts['video_id'])) {
        // Query related guests using ACF relationship field
        $related_guests = get_field('rel_guest_video', $atts['video_id']);
        ?>
        <pre style='background:bisque'><?php print_r($related_guests); ?></pre>
        <?php

        // Output guest info
        if ($related_guests) {
            foreach ($related_guests as $guest) {
                $first_name = get_field('first_name', $guest->ID);
                $last_name = get_field('last_name', $guest->ID);
                
                // Display guest info
                echo '<div class="guest-info">';
                echo 'First Name: ' . $first_name . '<br>';
                echo 'Last Name: ' . $last_name . '<br>';
                echo '</div>';
            }
        } else {
            echo 'No related guests found.';
        }

        // Reset post data
        wp_reset_postdata();
    } else {
        echo 'Invalid video ID.';
    }
}

解决方案

双向关联本身不会导致这个问题，问题出在ACF双向关联的取值逻辑上，以下是排查和修复步骤：

ACF双向关联的核心逻辑：ACF的双向关联只是在后台编辑界面同步显示关联关系，但数据实际只存储在建立关联操作的那一端。比如你编辑guest时关联了某个video，这条关联数据会存在guest的meta字段里，而不是video的meta字段里。直接用get_field从videoID读取，自然拿不到数据。
修复代码：反向查询关联数据
替换原代码中$related_guests = get_field('rel_guest_video', $atts['video_id']);这一行，改用反向查询获取关联的guest：

// 反向查询所有关联当前video的guest
$related_guests = get_posts(array(
    'post_type'      => 'guest',
    'meta_query'     => array(
        array(
            'key'     => 'rel_guest_video',
            'value'   => '"' . $atts['video_id'] . '"', // ACF序列化存储关联，需带引号匹配
            'compare' => 'LIKE'
        )
    ),
    'posts_per_page' => -1, // 获取全部关联项
    'post_status'    => 'publish' // 只查询已发布的guest
));

额外优化与排查点
1. 删除wp_reset_postdata()：当前代码未修改全局$post变量，调用此函数无意义，可移除
2. 验证video_id有效性：可以添加get_post($atts['video_id'])判断该ID是否对应真实存在的video文章
3. 查看原始meta数据：用var_dump(get_post_meta($atts['video_id'], 'rel_guest_video', true))确认video的meta字段是否真的存储了关联数据，如果为空，说明关联是在guest端创建的，必须用反向查询
4. 检查ACF字段配置：确保rel_guest_video字段在video和guest类型中都设置了正确的关联目标类型

内容的提问来源于stack exchange，提问作者Eric Hepperle - CodeSlayer2010