ACF Relationship字段检查及关联条目增删异常排查

问题根因 #

异常和字段序列化存储无关，核心是unset()语法使用错误：
现有写法unset($current_bookmarks, $key)会将$current_bookmarks整个数组变量、$key变量作为两个独立变量全部销毁，而非删除数组内指定键对应的元素，直接导致整个数组结构被破坏。
ACF的Relationship关系字段本身存储的是文章ID构成的一维数组，读取后可以直接操作，不存在序列化导致的键值匹配错误问题。

正确实现代码 #

$current_user_id = get_current_user_id();
$user_storage_key = 'user_' . $current_user_id;
// 空值兜底，首次无收藏数据时返回空数组，避免类型报错
$current_bookmarks = get_field('webinar_bookmarks', $user_storage_key) ?: [];

if (in_array($webinar_post, $current_bookmarks)) {
    // 已收藏状态：移除对应文章条目
    $target_key = array_search($webinar_post, $current_bookmarks);
    // 正确删除数组指定键元素
    unset($current_bookmarks[$target_key]);
    // 重排为连续数字索引，避免ACF识别异常
    $current_bookmarks = array_values($current_bookmarks);
} else {
    // 未收藏状态：新增文章到收藏列表
    $current_bookmarks[] = $webinar_post;
}
// 持久化保存修改后的收藏数据
update_field('webinar_bookmarks', $current_bookmarks, $user_storage_key);

关键注意点 #

• 必须给读取到的收藏数组做空值兜底：用户首次无收藏记录时get_field会返回null，直接传入in_array、array_search会触发PHP类型错误
• 删除数组元素后必须调用array_values()重建连续索引：ACF关系字段要求传入索引从0开始的连续数组，非连续索引的数组存回时会出现数据丢失
• 数组修改完成后必须调用update_field()持久化数据，否则所有修改仅在当前请求生命周期内生效，刷新后数据会还原

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