批量调用add_row()添加ACF repeater行速度过慢，求优化方案

你遇到的问题很典型——add_row()函数每次调用都会单独执行一次数据库读写操作：先读取当前repeater的所有数据，追加新行后再写回数据库。200次调用就意味着200次重复的DB交互，这自然会拖慢速度甚至触发超时。下面给你几个实用的优化方案：

方案1：一次性更新整个Repeater数组（最推荐） #

直接把所有新行合并到现有repeater数据中，然后用update_field()一次性写入数据库，只需要1次DB操作，效率会提升数倍。

示例代码：

// 导入数据数组
$new_rows = array( array(1,2,3), array(1,2,3), array(1,2,3) ); // 替换成你的200行数据

// 获取当前repeater已有的数据（需要保留原有数据时用）
$existing_rows = get_field('repeater_field', 40);
// 处理空值：如果repeater还没数据，初始化为空数组
if (empty($existing_rows)) {
    $existing_rows = array();
}

// 格式化新行并合并到现有数据
foreach ($new_rows as $row_data) {
    $formatted_row = array(
        'value1' => $row_data[0],
        'value2' => $row_data[1],
        'value3' => $row_data[2]
    );
    $existing_rows[] = $formatted_row;
}

// 一次性更新整个repeater字段
update_field('repeater_field', $existing_rows, 40);

方案2：临时提升PHP执行时间（应急方案） #

如果因为某些原因必须使用add_row()（比如依赖acf/save_post这类钩子逻辑），可以临时延长PHP的执行时间，避免超时。不过这只是治标不治本的方法，不推荐用于生产环境的大规模数据导入。

示例代码：

// 临时将执行时间设置为300秒（5分钟），可按需调整
set_time_limit(300);

// 导入数据数组
$rows = array( array(1,2,3), array(1,2,3), array(1,2,3) );
// 循环添加到repeater字段
foreach ($rows as $row) {
    $row = array(
        'value1' => $row[0],
        'value2' => $row[1],
        'value3' => $row[2]
    );
    add_row('repeater_field', $row, 40);
}

// 恢复默认执行时间（可选）
set_time_limit(ini_get('max_execution_time'));

方案3：分批次异步处理（适合超大规模数据） #

如果数据量超过500行，甚至可以考虑分批次处理，用WordPress的定时任务来异步执行每一批次的导入，避免长时间占用请求进程。

示例思路：

// 第一步：将需要导入的数据存储到临时选项中
update_option('acf_import_temp_rows', $all_rows);
update_option('acf_import_current_offset', 0);

// 第二步：触发第一个批次的导入
wp_schedule_single_event(time(), 'acf_batch_import_rows');

// 第三步：注册定时任务回调
add_action('acf_batch_import_rows', function() {
    $batch_size = 50; // 每批次处理50行
    $offset = get_option('acf_import_current_offset', 0);
    $all_rows = get_option('acf_import_temp_rows', array());
    
    $batch_rows = array_slice($all_rows, $offset, $batch_size);
    
    foreach ($batch_rows as $row_data) {
        $formatted_row = array(
            'value1' => $row_data[0],
            'value2' => $row_data[1],
            'value3' => $row_data[2]
        );
        add_row('repeater_field', $formatted_row, 40);
    }
    
    $new_offset = $offset + $batch_size;
    if ($new_offset < count($all_rows)) {
        update_option('acf_import_current_offset', $new_offset);
        // 继续调度下一批次（间隔10秒避免资源占用过高）
        wp_schedule_single_event(time() + 10, 'acf_batch_import_rows');
    } else {
        // 导入完成，清理临时数据
        delete_option('acf_import_temp_rows');
        delete_option('acf_import_current_offset');
    }
});

优先推荐方案1，它从根源上减少了数据库交互次数，是效率最高的解决方式。

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