在WordPress开发场景中，通过AJAX处理耗时较长的任务时，开发者经常会遇到一个典型问题：任务执行过程中修改的选项值，在前端或者其他后续请求中无法实时获取到最新结果，甚至出现值回滚的情况。这种情况会直接影响功能的正确性，比如批量处理文章状态、同步第三方数据时，状态标记无法及时生效。
问题产生的核心原因
要解决问题首先需要明确背后的机制，WordPress AJAX长任务中选项值无法实时更新主要有三个常见原因：
- 对象缓存未清理：WordPress默认会对
get_option的查询结果做对象缓存，长任务中如果多次调用update_option但没有主动清理缓存，后续读取时可能拿到旧的缓存值。 - 长任务执行中断：PHP默认的执行时长限制可能导致长任务中途中断，
update_option的写入操作没有完成，或者事务未提交就终止。 - 并发请求冲突：如果长任务执行期间有其他请求同时读写同一个选项，可能会出现锁竞争导致写入失败或者值被覆盖。
具体解决方案
1. 主动清理选项缓存
每次更新选项后，主动调用wp_cache_delete清理对应的缓存，确保后续读取能拿到最新值。以下是AJAX处理函数的示例代码：
// AJAX处理函数，处理长任务中的选项更新
add_action('wp_ajax_long_task_update_option', 'handle_long_task_update_option');
function handle_long_task_update_option() {
// 验证nonce
check_ajax_referer('long_task_nonce', 'security');
// 获取当前选项值
$current_val = get_option('long_task_progress', 0);
// 模拟长任务处理，每次更新进度
for ($i = 1; $i <= 10; $i++) {
$new_val = $current_val + $i;
// 更新选项值
update_option('long_task_progress', $new_val);
// 主动清理缓存，避免读取到旧值
wp_cache_delete('long_task_progress', 'options');
// 模拟耗时操作
sleep(1);
}
wp_die(json_encode(array('status' => 'success', 'progress' => $new_val)));
}
2. 拆分长任务避免执行中断
如果长任务耗时超过PHP的max_execution_time限制，可以将任务拆分成多个小批次，通过多次AJAX请求逐步完成，每次请求只处理一小部分并更新选项。前端调用示例如下：
// 前端拆分任务请求
let currentStep = 0;
const totalStep = 10;
function runLongTask() {
if (currentStep >= totalStep) {
console.log('任务完成');
return;
}
jQuery.ajax({
url: ajaxurl,
type: 'post',
data: {
action: 'long_task_update_option',
security: '<?php echo wp_create_nonce("long_task_nonce"); ?>',
step: currentStep
},
success: function(res) {
currentStep++;
// 更新前端进度显示
console.log('当前进度：' + res.progress);
// 继续下一次请求
runLongTask();
}
});
}
// 启动任务
runLongTask();
3. 使用数据库事务保证写入完整性
如果选项更新依赖多个关联操作，可以使用WordPress的数据库事务，确保所有操作都完成后再提交，避免中途中断导致值不一致。示例代码：
add_action('wp_ajax_transaction_update_option', 'handle_transaction_update_option');
function handle_transaction_update_option() {
global $wpdb;
check_ajax_referer('long_task_nonce', 'security');
// 开启事务
$wpdb->query('START TRANSACTION');
try {
// 第一步：更新选项值
$update_res = update_option('long_task_status', 'processing');
wp_cache_delete('long_task_status', 'options');
// 第二步：模拟其他关联操作
$wpdb->insert(
$wpdb->prefix . 'task_log',
array('task_name' => 'long_task', 'status' => 'processing', 'time' => current_time('mysql'))
);
// 所有操作成功，提交事务
$wpdb->query('COMMIT');
wp_die(json_encode(array('status' => 'success')));
} catch (Exception $e) {
// 操作失败，回滚事务
$wpdb->query('ROLLBACK');
wp_die(json_encode(array('status' => 'error', 'msg' => $e->getMessage())));
}
}
4. 避免并发冲突
如果长任务执行期间可能有其他请求读写同一个选项，可以在更新前加一个简单的锁标记，防止并发写入冲突。示例如下：
function safe_update_option($option_name, $new_value) {
// 检查是否有锁
if (get_option($option_name . '_lock') == 1) {
return false;
}
// 加锁
update_option($option_name . '_lock', 1);
wp_cache_delete($option_name . '_lock', 'options');
// 执行更新
$res = update_option($option_name, $new_value);
wp_cache_delete($option_name, 'options');
// 解锁
update_option($option_name . '_lock', 0);
wp_cache_delete($option_name . '_lock', 'options');
return $res;
}
验证方案有效性
完成代码修改后，可以通过以下方式验证选项值是否能实时更新：
- 在长任务执行过程中，通过另一个浏览器标签页访问
get_option的测试接口，查看返回的选项值是否逐步变化。 - 查看WordPress数据库的
wp_options表，确认选项值的更新时间和内容是否符合预期。 - 模拟长任务中断场景，检查选项值是否没有出现回滚或者丢失的情况。
以上方案可以根据实际场景组合使用，大部分WordPress AJAX长任务中选项值无法实时更新的问题都可以通过这些方法解决。