WordPress update_user_metadata无法获取$prev_value问题求助

这是WordPress开发中很常见的钩子使用误区，我来帮你拆解可能的原因和对应的解决办法：

1. 函数参数顺序错误（最常见原因） #

update_user_metadata过滤器的参数顺序很容易搞混，如果你没有按正确顺序接收参数，拿到的$prev_value就会是null。

正确的参数顺序是：

1. $check：默认null，用来控制是否提前终止元数据更新
2. $user_id：目标用户的ID
3. $meta_key：要更新的元字段键名
4. $new_value：新的字段值
5. $old_value：实际的旧字段值（这才是你要的$prev_value）

如果你的函数参数顺序写错了（比如把$old_value放在了第一个位置），那自然会拿到null。

修正示例： #

function myplugin_init() {
    add_filter( 'update_user_metadata', 'myplugin_update_foo', 10, 5 );
}
add_action( 'init', 'myplugin_init' );

// 严格按参数顺序接收
function myplugin_update_foo( $check, $user_id, $meta_key, $new_value, $old_value ) {
    // 只处理我们关心的字段
    if ( 'your_target_field' !== $meta_key ) {
        return $check; // 放行其他字段的更新
    }

    // 检查值是否变更
    if ( $old_value !== $new_value ) {
        // 这里执行你的变更后逻辑
        error_log("用户{$user_id}的{$meta_key}字段值从「{$old_value}」变为「{$new_value}」");
    }

    return $check; // 不要阻止默认的更新操作
}

2. 其他代码显式传入了null作为$prev_value #

如果有其他插件或主题代码调用update_user_meta时，显式传了null作为第四个参数（也就是$prev_value），那么钩子中拿到的$old_value就会是这个传入的null，而不是数据库里的实际旧值。

比如错误的调用方式：

// 显式传null会导致钩子中的$prev_value为null
update_user_meta( $user_id, 'your_target_field', 'new_value', null );

解决办法： #

确保所有调用update_user_meta的地方，要么不传第四个参数（使用默认值''），要么传入实际要匹配的旧值。正确的调用方式：

// 不传第四个参数，WordPress会自动读取数据库中的旧值
update_user_meta( $user_id, 'your_target_field', 'new_value' );

3. 字段名拼写错误或字段已被删除 #

虽然你说之前字段有值，但也有可能是钩子中监听的$meta_key和实际存储的字段名拼写不一致，或者字段已经被其他代码意外删除了。

验证方法： #

可以在钩子中先打印出当前的$meta_key和数据库中的实际值，确认是否匹配：

function myplugin_update_foo( $check, $user_id, $meta_key, $new_value, $old_value ) {
    // 打印当前字段名和数据库中实际存在的值
    error_log( "当前监听的字段：{$meta_key}" );
    error_log( "数据库中实际值：" . get_user_meta( $user_id, $meta_key, true ) );
    return $check;
}

查看服务器的错误日志，就能确认字段是否存在、键名是否正确。

4. 字段是序列化的复杂数据（少见但可能） #

如果你的字段存储的是数组、对象等复杂数据，WordPress会自动序列化后存入数据库。但钩子中的$old_value应该是反序列化后的原始数据，不会是null。不过如果你直接把它当成字符串打印，可能会显示为Array或Object，容易误以为是null。

验证方法： #

用var_dump()查看$old_value的实际类型：

var_dump( $old_value );

这样就能看到它的真实结构了。

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