WordPress+ACF repeater批量更新超时问题优化求助

我基于WordPress搭建站点，使用company自定义文章类型，并为每个公司配置了ACF Repeater字段com_array_data，需要通过$data数组批量更新该字段的数据。

原代码逻辑是先对比Repeater现有行数与数组行数，增删行后逐个更新子字段，但数据量较大时，仅处理5-6个公司就触发超时。优化后改为直接批量赋值更新，仍然出现PHP Fatal error: Maximum execution time of 320 seconds exceeded ... wp-includes/class-wpdb.php的超时错误。现寻求代码评审及性能优化方案，包括直接操作MySQL的实现方法。

原代码 #

// 获取ACF Repeater当前的字段行数
$com_array_data = get_field('com_array_data', $company_id);
if (is_array($com_array_data) || $com_array_data instanceof Countable) {
    $count = count($com_array_data);
} else {
    $count = 0;
}
// 获取数组中的数据行数
$data_count = count($data['candles']['data']);

// 如果Repeater行数少于数组行数，补充缺失的行
if ($count < $data_count) {
    for ($i = $count; $i < $data_count; $i++) {
        add_row('com_array_data', array(
            'open' => '',
            'close' => '',
            'high' => '',
            'low' => '',
            'value' => '',
            'volume' => '',
            'begin' => '',
            'end' => ''
        ), $company_id);
    }
}

// 如果Repeater行数多于数组行数，删除多余的行
if ($count > $data_count) {
    for ($i = $count; $i > $data_count; $i--) {
        delete_row('com_array_data', $i, $company_id);
    }
}

// 更新Repeater中的字段值
if (have_rows($com_array_data)) {
    while (have_rows($com_array_data)) {
        the_row();
        $row_index = get_row_index();
        update_sub_field('open', $data['candles']['data'][$row_index - 1][0], $company_id);
        update_sub_field('close', $data['candles']['data'][$row_index - 1][1], $company_id);
        update_sub_field('high', $data['candles']['data'][$row_index - 1][2], $company_id);
        update_sub_field('low', $data['candles']['data'][$row_index - 1][3], $company_id);
        update_sub_field('value', $data['candles']['data'][$row_index - 1][4], $company_id);
        update_sub_field('volume', $data['candles']['data'][$row_index - 1][5], $company_id);
        update_sub_field('begin', $data['candles']['data'][$row_index - 1][6], $company_id);
        update_sub_field('end', $data['candles']['data'][$row_index - 1][7], $company_id);
    }
}

优化后代码 #

$values = array();
foreach ($data['candles']['data'] as $row) {
    $values[] = array(
        'open' => $row[0],
        'close' => $row[1],
        'high' => $row[2],
        'low' => $row[3],
        'value' => $row[4],
        'volume' => $row[5],
        'begin' => $row[6],
        'end' => $row[7]
    );
}

if ($count > 0) {
    update_field('com_array_data', $values, $company_id);
} else {
    add_row('com_array_data', $values, $company_id);
}

代码评审 #

原代码核心问题 #

• 数据库请求爆炸：add_row、delete_row、update_sub_field每个方法都会单独发起数据库请求，当Repeater行数较多时，请求量呈线性增长，直接触发超时。
• 冗余逻辑：先增删行再逐个更新子字段完全是重复操作，ACF的update_field本身支持直接覆盖整个Repeater数据，无需提前调整行数。

优化后代码的不足 #

• 不必要的判断：无需判断$count > 0，update_field可以直接处理空值场景，原Repeater为空时调用update_field同样能正确写入数据，不需要单独调用add_row。
• 未规避ACF额外开销：update_field内部会触发ACF钩子（如acf/update_value）、数据验证和格式化，还会更新post的modified时间，批量处理时这些操作会累积大量耗时。

性能优化方案 #

1. ACF层面的轻量化优化 #

简化更新逻辑+禁用ACF额外操作

去掉冗余判断，同时禁用ACF的钩子和验证，大幅减少函数内部开销：

$values = array();
foreach ($data['candles']['data'] as $row) {
    $values[] = array(
        'open' => $row[0],
        'close' => $row[1],
        'high' => $row[2],
        'low' => $row[3],
        'value' => $row[4],
        'volume' => $row[5],
        'begin' => $row[6],
        'end' => $row[7]
    );
}

// 第四个参数设为false，跳过ACF钩子和数据验证
update_field('com_array_data', $values, $company_id, false);

批量公司数据分批处理

如果需要处理大量公司，将公司列表拆分批次，用定时任务延迟处理下一批，避免单次请求超时：

function batch_update_company_acf_data($company_ids, $data, $batch_size = 10) {
    $current_batch = array_splice($company_ids, 0, $batch_size);
    
    foreach ($current_batch as $company_id) {
        $values = array();
        foreach ($data['candles']['data'] as $row) {
            $values[] = array(
                'open' => $row[0],
                'close' => $row[1],
                'high' => $row[2],
                'low' => $row[3],
                'value' => $row[4],
                'volume' => $row[5],
                'begin' => $row[6],
                'end' => $row[7]
            );
        }
        update_field('com_array_data', $values, $company_id, false);
    }
    
    // 剩余公司调度10秒后处理
    if (!empty($company_ids)) {
        wp_schedule_single_event(time() + 10, 'batch_update_company_acf_data', array($company_ids, $data, $batch_size));
    }
}

// 使用示例：$all_company_ids为所有需要更新的公司ID数组
// batch_update_company_acf_data($all_company_ids, $data);

2. 直接操作MySQL数据库 #

ACF Repeater字段存储在wp_postmeta表中：主字段com_array_data存储行数，子字段格式为com_array_data_{行号}_{子字段名}（行号从1开始），同时会存储字段key的记录（meta_key为_com_array_data）。

实现代码

global $wpdb;

// 替换为你实际的ACF字段key（可在字段编辑页面URL中查看）
$field_key = 'field_1234567890abc';
$meta_key_base = 'com_array_data';
$company_id = 123; // 目标公司ID

// 整理需要写入的数据
$values = array();
foreach ($data['candles']['data'] as $row) {
    $values[] = array(
        'open' => $row[0],
        'close' => $row[1],
        'high' => $row[2],
        'low' => $row[3],
        'value' => $row[4],
        'volume' => $row[5],
        'begin' => $row[6],
        'end' => $row[7]
    );
}

// 1. 删除该公司原有Repeater相关数据
$wpdb->query($wpdb->prepare(
    "DELETE FROM {$wpdb->postmeta} WHERE post_id = %d AND meta_key LIKE %s",
    $company_id,
    $meta_key_base . '%'
));
$wpdb->query($wpdb->prepare(
    "DELETE FROM {$wpdb->postmeta} WHERE post_id = %d AND meta_key = %s",
    $company_id,
    '_' . $meta_key_base
));

// 2. 写入字段key记录
$wpdb->insert(
    $wpdb->postmeta,
    array(
        'post_id' => $company_id,
        'meta_key' => '_' . $meta_key_base,
        'meta_value' => $field_key
    )
);

// 3. 写入Repeater总行数
$wpdb->insert(
    $wpdb->postmeta,
    array(
        'post_id' => $company_id,
        'meta_key' => $meta_key_base,
        'meta_value' => count($values)
    )
);

// 4. 批量写入子字段数据
$insert_rows = array();
foreach ($values as $index => $row) {
    $row_num = $index + 1;
    foreach ($row as $sub_field => $value) {
        $insert_rows[] = array(
            'post_id' => $company_id,
            'meta_key' => $meta_key_base . '_' . $row_num . '_' . $sub_field,
            'meta_value' => $value
        );
    }
}

if (!empty($insert_rows)) {
    $columns = array_keys($insert_rows[0]);
    $placeholders = array();
    $data = array();
    foreach ($insert_rows as $row) {
        $placeholders[] = '(' . implode(',', array_fill(0, count($columns), '%s')) . ')';
        foreach ($row as $value) {
            $data[] = $value;
        }
    }
    $sql = "INSERT INTO {$wpdb->postmeta} (" . implode(',', $columns) . ") VALUES " . implode(',', $placeholders);
    $wpdb->query($wpdb->prepare($sql, $data));
}

// 可选：更新post修改时间，保持数据一致性
$wpdb->update(
    $wpdb->posts,
    array('post_modified' => current_time('mysql'), 'post_modified_gmt' => current_time('mysql', 1)),
    array('ID' => $company_id)
);

注意事项

• 必须替换为实际的ACF字段key，可在字段编辑页面的URL中找到field_key参数。
• 直接操作数据库会跳过ACF所有钩子和验证，确保数据格式正确后再执行。
• 若子字段数据量极大，需进一步拆分批量插入，避免触发MySQL的max_allowed_packet限制。

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