如何在ACF Block中存储关联CPT的自定义唯一编号为数组？

你的思路完全可行——通过同步选中文章的自定义唯一编号到独立字段，确实能解决测试/生产环境Post ID不一致的问题。下面提供两种具体实现方案，按需选择：

方案一：自动同步到隐藏文本数组字段 #

这种方式保留原Relationship字段的编辑体验，同时在后台自动把选中文章的唯一编号存入一个辅助字段，导出页面时携带这个字段的值即可。

步骤1：创建辅助字段 #

在ACF中新增一个文本字段，设置：

• 字段名：related_posts_unique_ids（可自定义）
• 返回格式：数组
• 外观：设置为「隐藏」（或在编辑界面不显示）

步骤2：添加同步代码 #

将以下代码添加到主题的functions.php或自定义插件中：

// 同步Relationship选中项到唯一编号数组
add_action('acf/save_post', 'sync_relationship_to_unique_ids');
function sync_relationship_to_unique_ids($post_id) {
    // 替换为你的Relationship字段key和辅助字段key
    $rel_field_key = 'field_xxxxxx'; 
    $unique_ids_field_key = 'field_yyyyyy';
    // 替换为你的自定义唯一字段名
    $unique_field_name = 'article_unique_code';

    // 获取选中的文章ID数组
    $selected_posts = get_field($rel_field_key, $post_id);
    $unique_ids = [];

    if ($selected_posts) {
        foreach ($selected_posts as $post) {
            $unique_id = get_field($unique_field_name, $post);
            if ($unique_id) {
                $unique_ids[] = $unique_id;
            }
        }
    }

    // 保存到辅助字段
    update_field($unique_ids_field_key, $unique_ids, $post_id);
}

步骤3：Block渲染时用编号查询文章 #

在你的ACF Block模板中，不再读取原Relationship字段，而是用辅助字段的编号查询生产环境的文章：

// 获取存储的唯一编号数组
$unique_ids = get_field('related_posts_unique_ids');
$related_posts = [];

if ($unique_ids) {
    foreach ($unique_ids as $id) {
        // 替换为你的CPT别名和唯一字段名
        $found_post = get_posts([
            'post_type' => 'your_cpt_slug',
            'meta_key' => 'article_unique_code',
            'meta_value' => $id,
            'posts_per_page' => 1,
            'post_status' => 'publish'
        ]);
        if ($found_post) {
            $related_posts[] = $found_post[0];
        }
    }
}

// 渲染关联内容
if ($related_posts) {
    foreach ($related_posts as $post) {
        setup_postdata($post);
        echo '<div class="related-post">';
        echo '<h3>' . get_the_title() . '</h3>';
        echo '<p>' . get_field('post_summary', $post->ID) . '</p>';
        echo '</div>';
    }
    wp_reset_postdata();
}

方案二：直接修改Relationship字段的存储值 #

如果不想新增辅助字段，可以直接修改ACF Relationship字段的存储逻辑，把Post ID替换成自定义唯一编号。

代码实现 #

添加以下代码到主题functions.php或自定义插件：

// 保存Relationship字段时，存储自定义唯一编号而非Post ID
add_filter('acf/update_value/type=relationship', 'save_relationship_as_unique_id', 10, 3);
function save_relationship_as_unique_id($value, $post_id, $field) {
    $unique_ids = [];
    // 替换为你的自定义唯一字段名
    $unique_field_name = 'article_unique_code';

    if ($value) {
        foreach ($value as $post) {
            $unique_id = get_field($unique_field_name, $post);
            if ($unique_id) {
                $unique_ids[] = $unique_id;
            }
        }
    }
    return $unique_ids;
}

// 读取Relationship字段时，根据唯一编号返回对应的文章ID
add_filter('acf/load_value/type=relationship', 'load_relationship_from_unique_id', 10, 3);
function load_relationship_from_unique_id($value, $post_id, $field) {
    $post_ids = [];
    // 替换为你的CPT别名和自定义唯一字段名
    $cpt_slug = 'your_cpt_slug';
    $unique_field_name = 'article_unique_code';

    if ($value) {
        foreach ($value as $unique_id) {
            $found_post = get_posts([
                'post_type' => $cpt_slug,
                'meta_key' => $unique_field_name,
                'meta_value' => $unique_id,
                'posts_per_page' => 1,
                'post_status' => 'publish'
            ]);
            if ($found_post) {
                $post_ids[] = $found_post[0]->ID;
            }
        }
    }
    return $post_ids;
}

关键注意事项 #

• 自定义唯一编号必须全局唯一，确保测试/生产环境的同篇文章编号完全一致；
• 导出页面时，要确保包含存储编号的字段（ACF导出工具默认会包含所有自定义字段）；
• 生产环境导入后，先验证CPT文章的唯一编号是否和测试环境匹配，再测试Block渲染效果。

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