求助：WooCommerce GraphQL API仅返回部分产品变体（12个仅返回10个）

我在WordPress中使用WooCommerce，通过GraphQL接口获取某产品的变体时遇到问题——该产品共有12个变体，但API仅返回10个，导致Next.js前端无法展示全部选项。

使用的GraphQL查询如下：

query GetProduct($id: ID!) {
  product(id: $id) {
    ... on VariableProduct {
      variations {
        nodes {
          id
          price
          attributes {
            nodes {
              name
              value
            }
          }
          image {
            sourceUrl
          }
        }
      }
    }
  }
}

预期结果：返回该产品的所有12个变体
实际结果：仅返回前10个变体

怀疑是GraphQL或WooCommerce的默认分页限制导致，但不清楚调整位置，求解决方法。

相关截图：

解决方案 #

1. 在查询中显式指定返回数量（first 参数） #

WooCommerce GraphQL的variations字段默认分页限制是10条，你可以通过添加first参数指定要获取的变体总数，只要数值大于等于你的实际变体数量即可：

query GetProduct($id: ID!) {
  product(id: $id) {
    ... on VariableProduct {
      # 指定获取最多100个变体（可根据实际情况调整）
      variations(first: 100) {
        nodes {
          id
          price
          attributes {
            nodes {
              name
              value
            }
          }
          image {
            sourceUrl
          }
        }
        # 可选：获取分页信息，确认是否还有更多变体
        pageInfo {
          hasNextPage
          endCursor
        }
      }
    }
  }
}

2. 变体数量极大时处理分页逻辑 #

如果产品变体数量非常多（比如超过100个），建议通过分页逐步获取：

• 先查询第一页（first: 100），通过pageInfo中的hasNextPage和endCursor判断是否有下一页
• 下一页查询时使用after: $endCursor参数，继续获取剩余变体

3. 全局调整WooGraphQL的默认分页限制（可选） #

如果需要全局修改默认返回数量，可以在WordPress主题的functions.php中添加以下代码：

add_filter( 'woographql_connection_max_query_amount', 'custom_woographql_max_query_amount' );
function custom_woographql_max_query_amount( $max_amount ) {
    // 修改为你需要的最大数量，比如200
    return 200;
}

注意：不要设置过大的数值，避免影响API性能。

内容的提问来源于stack exchange，提问作者Vũ Tiến Quốc