用户角色变更时添加/更新user_meta失败，求技术排查

你的代码思路没问题，但大概率卡在了触发场景和元数据处理的细节上，我帮你拆解并修正：

1. 核心问题：钩子的触发场景限制 #

WordPress的set_user_role钩子仅在手动调用wp_set_user_role()函数时触发，但后台编辑用户页面修改角色时，系统是直接更新用户的capabilities元数据，并不会触发这个钩子——这几乎是你代码没生效的主要原因。

另外补充一点：set_user_role的实际参数是$user_id, $role, $old_roles，你在add_action里指定接收2个参数的写法是对的，$new_role能正常拿到新角色值，但这个钩子的适用场景确实比较窄。

2. 次要问题：元数据重复添加 #

add_user_meta每次调用都会新增一条元数据，如果用户多次变更角色，数据库里会堆积多个roleupdated条目。更合理的做法是用update_user_meta，它会自动判断：元数据存在就更新，不存在则新增。

修正后的代码方案 #

如果你需要覆盖后台编辑用户+手动调用函数两种场景，推荐用profile_update钩子，同时检查角色是否真的发生变化：

function track_user_role_update( $user_id, $old_user_data ) {
    // 获取用户当前的角色集合
    $current_user = get_userdata( $user_id );
    $current_roles = $current_user->roles;
    
    // 获取用户修改前的角色集合
    $old_roles = $old_user_data->roles;
    
    // 仅当角色确实变化时，更新时间戳
    if ( $current_roles !== $old_roles ) {
        update_user_meta( $user_id, 'roleupdated', current_time( 'mysql' ) );
    }
}
add_action( 'profile_update', 'track_user_role_update', 10, 2 );

如果你的场景只需要处理wp_set_user_role调用的情况，也可以优化原代码：

function user_role_update( $user_id, $new_role ) {
    // 用update_user_meta替代add_user_meta，避免重复存储数据
    update_user_meta( $user_id, 'roleupdated', current_time( 'mysql' ) );
}
add_action( 'set_user_role', 'user_role_update', 10, 2 );

验证小技巧 #

你可以通过这两种方式测试代码是否生效：

• 后台编辑用户角色后，用用户元数据管理插件（比如User Meta Manager）查看roleupdated字段是否存在并更新
• 在主题functions.php或自定义插件里手动调用wp_set_user_role( $测试用户ID, 'editor' )，检查元数据变化

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