WordPress按元键筛选用户异常：自定义页面无用户显示问题排查

核心原因1：用户元数组的匹配逻辑错误 #

WordPress会自动把数组类型的用户元数据序列化后存储到数据库里，你提到的array(0 => '1')，在数据库里实际存的是类似a:1:{i:0;s:1:"1";}的字符串。原代码里用IN匹配数值1，还指定了type => 'NUMERIC'，完全匹配不上序列化后的数组内容，导致这部分筛选条件根本找不到任何用户。

核心原因2：自定义用户列表的渲染方式错误 #

直接给$users_table->items赋值后调用prepare_items()，会触发WP_Users_List_Table的默认数据获取逻辑，它会重新执行用户查询并覆盖你手动设置的items，最后就导致页面显示为空。

修正后的代码 #

// 添加自定义后台菜单
add_action( 'admin_menu', 'custom_users_menu_page' );

function custom_users_menu_page() {
    add_menu_page(
        '自定义用户', 
        '自定义用户', 
        'manage_options', 
        'custom-users', 
        'custom_users_callback' 
    );
}

// 渲染自定义用户页面
function custom_users_callback() {
    // 修正元查询逻辑：匹配序列化后的数组值
    $meta_query = array(
        'relation' => 'AND',
        array(
            'key'     => 'shipping-address-verified',
            'value'   => serialize( array( '1' ) ), // 用序列化后的字符串匹配数据库存储值
            'compare' => '='
        ),
        array(
            'key'     => 'shipped',
            'compare' => 'NOT EXISTS'
        )
    );

    // 查询符合条件的用户
    $args = array(
        'meta_query' => $meta_query,
        'orderby'    => 'user_registered',
        'order'      => 'DESC'
    );
    $users_query = new WP_User_Query( $args );
    $users = $users_query->get_results();

    // 手动渲染用户列表（避开WP_Users_List_Table的默认逻辑干扰）
    echo '<div class="wrap">';
    echo '<h1>自定义用户</h1>';
    
    if ( empty( $users ) ) {
        echo '<p>没有符合条件的用户</p>';
    } else {
        echo '<table class="wp-list-table widefat fixed striped users">';
        echo '<thead><tr>';
        echo '<th>用户名</th><th>邮箱</th><th>注册日期</th>';
        echo '</tr></thead><tbody>';
        
        foreach ( $users as $user ) {
            echo '<tr>';
            echo '<td>' . esc_html( $user->user_login ) . '</td>';
            echo '<td>' . esc_html( $user->user_email ) . '</td>';
            echo '<td>' . esc_html( date( 'Y-m-d H:i:s', strtotime( $user->user_registered ) ) ) . '</td>';
            echo '</tr>';
        }
        
        echo '</tbody></table>';
    }
    
    echo '</div>';
}

额外说明 #

1. 如果shipping-address-verified的数组结构可能有变化（比如包含多个元素），可以改用LIKE匹配，注意匹配序列化字符串中的目标值：

   array(
       'key'     => 'shipping-address-verified',
       'value'   => '"1"', // 匹配序列化字符串里的"1"
       'compare' => 'LIKE'
   )
   

2. 要是一定要用WP_Users_List_Table，得重写类的prepare_items方法或者禁用它的默认数据查询逻辑，但手动渲染的方式更简单直接。

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