WordPress选项更新与获取异常问题求助

问题现象 #

在WordPress多站点环境中，操作选项gtdp_games时频繁出现值不一致的异常：

• 调用update_option('gtdp_games', '[100,313,582,704,755,800]')后，get_option返回新值，但直接查询数据库仍显示旧值'test'
• 偶尔出现数据库值正确，但get_option返回旧值'test'的情况
• 临时通过先更新到中间值再设置目标值的方式能暂时解决，但问题仍会在不同站点随机出现，且已确认当前博客ID正确

可能原因 #

1. WordPress内置选项缓存机制：get_option优先读取内存中的$wp_options全局变量缓存，而非直接查询数据库。如果缓存未及时同步更新，就会出现与数据库值不一致的情况。
2. 多站点缓存隔离失效：多站点环境下，不同站点的选项依赖blog_id区分，但如果缓存逻辑未正确包含站点标识，可能出现跨站点缓存污染，导致读取到其他站点的旧值。
3. update_option的跳过逻辑：update_option会先对比当前缓存中的值与新值，若判定一致则跳过数据库更新操作。如果缓存值已被篡改，会导致函数误以为无需更新数据库。
4. 外部对象缓存干扰：若使用Redis、Memcached等对象缓存服务，缓存键未包含blog_id、缓存过期时间设置不合理，或缓存同步失败，都会引发新旧值不一致。

解决方案 #

1. 强制清除选项缓存 #

更新选项后手动清除对应缓存，确保get_option下次读取时从数据库拉取最新值：

update_option('gtdp_games', '[100,313,582,704,755,800]');
wp_cache_delete('gtdp_games', 'options'); // 清除该选项的缓存条目

2. 绕过缓存直接更新数据库（慎用） #

如果update_option的跳过逻辑导致问题，可以直接通过$wpdb更新数据库，再清除缓存：

global $wpdb;
$option_name = 'gtdp_games';
$new_value = '[100,313,582,704,755,800]';
$current_blog_id = get_current_blog_id();

// 多站点下需指定blog_id，避免修改其他站点选项
$wpdb->update(
    $wpdb->options,
    ['option_value' => $new_value],
    ['option_name' => $option_name, 'blog_id' => $current_blog_id]
);
wp_cache_delete($option_name, 'options');

3. 修复update_option的判断逻辑 #

先从数据库获取真实值，再对比更新，避免缓存干扰导致的跳过操作：

global $wpdb;
$option_name = 'gtdp_games';
$new_value = '[100,313,582,704,755,800]';
$current_blog_id = get_current_blog_id();

// 从数据库读取真实值，而非依赖缓存
$db_value = $wpdb->get_var($wpdb->prepare(
    "SELECT option_value FROM {$wpdb->options} WHERE option_name = %s AND blog_id = %d",
    $option_name,
    $current_blog_id
));

if ($db_value !== $new_value) {
    update_option($option_name, $new_value);
    wp_cache_delete($option_name, 'options');
}

4. 检查对象缓存配置 #

如果使用外部对象缓存服务：

• 确认缓存键包含blog_id（多站点必须），避免不同站点的选项缓存冲突
• 调整缓存过期时间，缩短选项类缓存的有效期
• 暂时禁用对象缓存，测试问题是否消失，以确认是否为缓存服务导致

验证方法 #

• 更新选项后，同时打印get_option结果和数据库查询结果，确认值是否一致
• 清除缓存后再次测试，观察问题是否复现
• 在多个站点分别测试，确认问题是否与特定站点或缓存配置有关

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