WPGraphQL按浏览量查询WordPress热门文章返回null问题求助

• 先校验浏览量meta字段写入逻辑
  你自行开发的插件首先要保证文章被访问时，浏览量数值能正常写入wp_postmeta表，对应的meta key要和后续Hook中调用的完全一致，大小写敏感。可以直接进入数据库查询对应文章ID的meta值，确认post_views_count（或你自定义的字段名）存在且值为有效数字，这一步出问题是返回null的最常见原因。
• 核对WPGraphQL扩展Hook注册代码
  你需要同时完成字段注册和查询参数绑定两个步骤，缺一不可，参考代码如下：

  // 注册浏览量字段到WPGraphQL的Post类型
  add_action('graphql_register_types', function() {
    register_graphql_field('Post', 'postViewsCount', [
      'type' => 'Int',
      'description' => '文章总浏览量',
      'resolve' => function($post) {
        return get_post_meta($post->ID, 'post_views_count', true) ?: 0;
      }
    ]);
    // 注册自定义排序参数
    register_graphql_input_field('RootQueryToPostConnectionWhereArgs', 'orderByPopularity', [
      'type' => 'Boolean',
      'description' => '按浏览量降序排序'
    ]);
  });
  
  // 绑定排序参数到WP查询逻辑
  add_filter('graphql_post_object_connection_query_args', function($query_args, $source, $args, $context, $info) {
    if (!empty($args['where']['orderByPopularity'])) {
      $query_args['meta_key'] = 'post_views_count';
      $query_args['orderby'] = 'meta_value_num';
      $query_args['order'] = 'DESC';
      // 可选：包含还没有浏览量记录的文章
      $query_args['meta_query'] = [
        'relation' => 'OR',
        ['key' => 'post_views_count', 'compare' => 'EXISTS'],
        ['key' => 'post_views_count', 'compare' => 'NOT EXISTS']
      ];
    }
    return $query_args;
  }, 10, 5);
  

• 确认GraphQL查询语句格式正确
  调用API时的查询语句要正确传入自定义排序参数，参考查询如下：

  query getPopularPosts {
    posts(where: {orderByPopularity: true}, first: 10) {
      nodes {
        id
        title
        postViewsCount
        date
        excerpt
      }
    }
  }
  

  可以先去掉自定义排序参数查询普通文章列表，确认WPGraphQL本身运行正常，再定位排序逻辑的问题。
• 排查权限与缓存影响
  确认你没有给浏览量meta字段设置读取权限限制，WPGraphQL的公开查询有权限读取该字段。另外清空WordPress站点缓存、WPGraphQL查询缓存后再重试，新注册的Hook经常会因为缓存未更新不生效。

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