如何按文章自定义元数据查询：未浏览文章筛选问题排查

一、筛选查询函数query_by_seen的核心错误 #

1. 未定义的$post->ID：在Elementor的查询钩子中，此时正执行文章列表的全局查询，还未遍历到单个文章，无法直接获取某篇文章的logged_viewers值，$post->ID在这里是无效的。
2. Meta Query参数错误：key应指定元字段名'logged_viewers'，而非某篇文章的用户列表；同时针对WordPress序列化存储的数组，需要用正确的比较逻辑。

修正后的query_by_seen函数：

function query_by_seen( $query ) {
    // 仅处理前台查询，避免影响后台操作
    if ( is_admin() || ! $query->is_main_query() ) {
        return;
    }

    $userID = get_current_user_id();
    // 未登录用户不做筛选
    if ( $userID === 0 ) {
        return;
    }

    $meta_query = $query->get( 'meta_query', [] );

    // 筛选条件：当前用户ID不在logged_viewers数组中
    $meta_query[] = [
        'key'     => 'logged_viewers',
        'value'   => '"' . $userID . '"', // 匹配序列化数组中的用户ID，避免误匹配相似ID
        'compare' => 'NOT LIKE',
    ];

    $query->set( 'meta_query', $meta_query );
}
add_action( 'elementor/query/query_by_seen', 'query_by_seen' );

二、浏览记录函数log_viewers的潜在问题 #

1. Nonce验证逻辑无效：刚创建的nonce立即验证，永远无法通过——nonce需要先输出到前端，再通过请求带回后端验证，当前写法完全起不到作用。
2. 重复执行更新：每次加载文章页面都会触发，即使用户已被记录，造成不必要的数据库操作。
3. 未过滤游客用户：游客的用户ID为0，会被错误存入浏览记录。

修正后的log_viewers函数：

function log_viewers() {
    global $post;
    // 仅在单个文章页面、用户已登录时执行
    if ( ! is_single() || get_current_user_id() === 0 ) {
        return;
    }

    $userID = get_current_user_id();
    $viewers = get_post_meta( $post->ID, 'logged_viewers', true );
    
    // 初始化数组
    if ( empty( $viewers ) || ! is_array( $viewers ) ) {
        $viewers = [];
    }

    // 用户已在列表中，无需更新
    if ( in_array( $userID, $viewers, true ) ) {
        return;
    }

    // 添加用户并去重
    $viewers[] = $userID;
    $viewers_list = array_unique( $viewers );

    update_post_meta( $post->ID, 'logged_viewers', $viewers_list );
}
add_action( 'wp_head', 'log_viewers' );

关键说明 #

• WordPress会自动序列化存储数组类型的元数据，因此查询时用NOT LIKE匹配带双引号的用户ID，可避免误匹配相似数字ID（比如ID=12和123）。
• 筛选函数增加了后台判断和未登录用户跳过逻辑，防止影响后台编辑和游客浏览体验。
• 浏览记录函数优化了触发条件，仅在必要时更新数据库，减少资源消耗。

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