如何解决WordPress自定义头像meta_key全站显示异常与统一头像问题？

问题背景 #

我开发了一个允许用户上传自定义头像的功能，图片已正确存储在image这个用户meta键中，但WordPress默认不识别这个键，需要通过get_avatar或get_avatar_url过滤器替换默认头像。但两次尝试的代码都存在问题：

• 第一次代码仅后台能看到自定义头像，前台评论区仍显示Gravatar默认头像
• 第二次代码虽然全站能显示头像，但所有用户的头像都相同

错误代码分析 #

第一次代码的问题 #

// Replace default Gravatar Image used in WordPress
add_filter( 'get_avatar', 'filter_get_avatar', 10, 5 );
function filter_get_avatar( $avatar, $current_user, $size, $default, $alt ) {    
    
  // If is email, try and find user ID
    if ( ! is_numeric( $current_user ) && is_email( $current_user->comment_author_email ) ) {
    $user = get_user_by( 'email', $current_user );
     if ( $user ) {
       $current_user = get_current_user_id(); // 核心错误
     }
    }

    // If not user ID, return
    if( ! is_numeric( $current_user ) ) {
     return $avatar;
    }

    // Get attachment id
    $attachment_id  = get_user_meta( $current_user, 'image', true );
    
    // NOT empty
    if ( ! empty ( $attachment_id  ) ) {
     // Return saved image
     return wp_get_attachment_image( $attachment_id, [ $size, $size ], false, ['alt' => $alt] );
    }
    return $avatar;
}

错误点：处理评论作者时，错误地将目标用户ID替换为当前登录用户的ID，而非评论作者的真实ID。前台评论区展示的是评论者的头像，这里却读取了当前登录用户的meta数据，导致评论者的自定义头像无法被正确加载。

第二次代码的问题 #

function wdoc_filter_get_avatar_url( $url, $id_or_email, $args ) {
    $current_user_id = get_current_user_id(); // 核心错误
    $file_id = get_user_meta( $current_user_id, 'image' , true );
    return wp_get_attachment_image_url($file_id);
}

add_filter( 'get_avatar_url', 'wdoc_filter_get_avatar_url', 10, 3 );

错误点：直接使用get_current_user_id()获取用户ID，不管当前要展示的是哪个用户的头像，都返回当前登录用户的自定义头像，导致所有用户的头像显示一致。

正确解决方案 #

使用get_avatar_url过滤器，正确解析传入的$id_or_email参数，获取对应用户的ID后再读取自定义头像：

function custom_get_avatar_url( $url, $id_or_email, $args ) {
    // 解析目标用户ID
    $user_id = 0;
    if ( is_numeric( $id_or_email ) ) {
        $user_id = $id_or_email;
    } elseif ( is_object( $id_or_email ) ) {
        if ( ! empty( $id_or_email->ID ) ) {
            $user_id = $id_or_email->ID;
        } elseif ( ! empty( $id_or_email->comment_author_email ) ) {
            // 处理评论作者对象
            $user = get_user_by( 'email', $id_or_email->comment_author_email );
            if ( $user ) {
                $user_id = $user->ID;
            }
        }
    } elseif ( is_email( $id_or_email ) ) {
        $user = get_user_by( 'email', $id_or_email );
        if ( $user ) {
            $user_id = $user->ID;
        }
    }

    // 读取并返回自定义头像URL
    if ( $user_id > 0 ) {
        $attachment_id = get_user_meta( $user_id, 'image', true );
        if ( ! empty( $attachment_id ) ) {
            $custom_avatar_url = wp_get_attachment_image_url( $attachment_id, [ $args['size'], $args['size'] ] );
            if ( $custom_avatar_url ) {
                return $custom_avatar_url;
            }
        }
    }

    // 无自定义头像时返回默认URL
    return $url;
}
add_filter( 'get_avatar_url', 'custom_get_avatar_url', 10, 3 );

代码说明 #

1. 参数解析：兼容$id_or_email的多种类型（用户ID、用户对象、评论对象、邮箱），确保能正确获取目标用户的ID
2. 自定义头像读取：根据解析出的用户ID，读取image meta中的附件ID，生成对应尺寸的头像URL
3. 兼容性保障：如果用户没有上传自定义头像，会自动返回WordPress默认的Gravatar地址

修改后，后台用户列表、前台评论区及其他所有展示头像的位置，都会正确显示对应用户的自定义头像。

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