WordPress GraphQL查询所有文章Yoast SEO字段值重复求助

问题场景 #

使用以下插件版本：

• WPGraphQL v2.3.8
• Add WPGraphQL SEO v5.0.0
• WP Gatsby v2.3.3

执行GraphQL查询：

{
  posts {
    nodes {
      id
      title
      seo {
        title   # yoast seo field
        metaDesc  # yoast seo field
      }
    }
  }
}

所有文章的id和外层title均为唯一值，但seo字段的title和metaDesc全部返回第一篇文章的对应值，且已确认WordPress数据库中的SEO数据是正确的。

排查与解决步骤 #

1. 清除相关缓存 #

• 清除WP Gatsby缓存：进入WordPress后台 → Gatsby → Settings，点击「Clear Cache」按钮
• 清除WPGraphQL缓存：使用WP-CLI执行命令 wp graphql clear-cache，或安装WPGraphQL Cache插件手动清除
• 同时清除WordPress自带缓存（若启用）及服务器端缓存

2. 隔离WP Gatsby插件测试 #

暂时禁用WP Gatsby插件，直接在WPGraphQL Playground中执行原查询：

• 若此时SEO数据恢复正常，说明问题出在WP Gatsby的数据同步或缓存逻辑，可尝试重新同步数据：后台→Gatsby→点击「Trigger Full Site Build」
• 若问题依旧，锁定问题为Add WPGraphQL SEO插件本身

3. 修复Add WPGraphQL SEO的上下文绑定问题 #

该插件可能因未正确绑定当前文章上下文，导致复用了第一篇文章的SEO数据。在主题的functions.php中添加以下代码修复：

add_filter( 'graphql_post_object_connection_query_args', function( $args, $source, $input, $context, $info ) {
    // 确保查询时保留行数据，避免上下文丢失
    if ( isset( $args['no_found_rows'] ) ) {
        $args['no_found_rows'] = false;
    }
    return $args;
}, 10, 5 );

add_action( 'graphql_after_resolve_field', function( $source, $args, $context, $info ) {
    // 解析SEO字段后重置Yoast SEO的临时缓存
    if ( isset( $info->fieldName ) && $info->fieldName === 'seo' ) {
        global $wpseo_front;
        if ( isset( $wpseo_front ) ) {
            $wpseo_front->reset();
        }
    }
}, 10, 4 );

4. 检查版本兼容性 #

当前Add WPGraphQL SEO v5.0.0与WPGraphQL v2.3.8可能存在兼容性问题：

• 尝试降级Add WPGraphQL SEO至v4.2.0（备份数据后操作）
• 或升级WPGraphQL至最新稳定版，再测试查询结果

5. 排查插件冲突 #

禁用其他可能影响GraphQL数据或文章SEO的插件（如其他SEO插件、自定义Post类型插件），逐一启用排查，确认是否存在冲突。

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