ACF嵌套Group字段更新技巧

本文详解如何使用 update_field() 函数精准更新 ACF 中「Group 字段内嵌 Group 字段」结构下的深层子字段（如工作时间表中的周一上午数值），避免 update_sub_field() 失效问题，并提供可直接复用的数组结构范例。

在 Advanced Custom Fields（ACF）中，当字段结构为「Group → Group → Sub-field」（即组内嵌组）时，update_sub_field() 无法直接生效——因为它仅适用于 Repeater 或 Flexible Content 的当前行上下文，而纯 Group 字段（非重复型）不触发 have_rows() / the_row() 循环逻辑。你代码中调用 have_rows('field_61f453c010074') 实际上是无效的，因为该字段是单实例 Group，不是 Repeater，导致整个循环体被跳过。

✅ 正确做法：使用 update_field() 一次性写入完整嵌套数组结构，严格遵循 ACF 对 Group 字段的存储格式要求：

• 外层 Group 字段（如 'Working hours'）值应为 单元素关联数组（即使只有一组数据）；
• 每个子 Group（如 'Monday'）作为该数组的一个键，其值为另一个关联数组，包含其下所有子字段的 field_key => value 映射；
• 所有字段键必须使用 ACF 字段 KEY（如 field_61f4573589282），而非字段名称（如 am）。

以下是针对你「周一 AM/PM 时间」场景的完整、可运行示例：

// 假设 $post_id 已通过 wp_insert_post() 获取
$post_id = 123;

// 构建符合 ACF Group 嵌套规则的数组结构
$value = array(
    array( // 外层 Group（'Working hours'）的唯一行（注意：是 array 包裹的单元素）
        'field_61f4570e89281' => array( // 'Monday' Group 字段 KEY
            'field_61f4573589282' => (int) $_POST['mon_am'], // 'Am' 子字段
            'field_61f4574589283' => (int) $_POST['mon_pm'], // 'Pm' 子字段
        ),
        'field_61f7a30ffbcf0' => array( // 'Tuesday' Group 字段 KEY
            'field_61f7a30ffbcf1' => (int) $_POST['tue_am'],
            'field_61f7a30ffbcf2' => (int) $_POST['tue_pm'],
        ),
        // ... 同理补充 Wednesday ~ Sunday
        'field_61f7a31ffbcf3' => array(
            'field_61f7a31ffbcf4' => (int) $_POST['sun_am'],
            'field_61f7a31ffbcf5' => (int) $_POST['sun_pm'],
        ),
    ),
);

// 一次性更新顶层 Group 字段
update_field('field_61f453c010074', $value, $post_id);

? 关键注意事项：

• ✅ 不要用 have_rows() 遍历 Group 字段：Group 是静态容器，无“行”概念；只有 Repeater、Flexible Content 才支持循环。
• ✅ 字段 KEY 必须准确：在 ACF 字段编辑页开启「显示字段键」开关（Screen Options → Show Field Keys），复制真实 key（如 field_61f4573589282），切勿手写或混淆为字段名。
• ✅ 类型强转建议：对数字类字段（Number）显式 (int) 或 (float) 转换，防止字符串写入导致前端验证失败。
• ⚠️ 若该 Group 字段被设置为「Clone」或「Conditional Logic」影响可见性，请确保提交数据时逻辑条件满足，否则字段可能被忽略。
• ? 调试技巧：提交后立即用 get_field('field_61f453c010074', $post_id) 输出检查结构是否符合预期，确认数组层级与 key 是否完全匹配。

此方法兼容 ACF Pro 6.x 及以上版本，稳定可靠，是处理深层嵌套 Group 字段更新的官方推荐实践。