YouTube.search API返回空数组：用Promise传nextPageToken仍无视频

看起来你在调用YouTube Search API做分页请求时遇到了空数组的问题，我帮你梳理几个常见原因和对应的解决办法：

1. 先修正代码里的明显拼写错误 #

你最后一个then块里写的data.nextPageToke少了一个字母n，应该是nextPageToken！这个拼写错误会导致后续请求传入的pageToken是undefined，API自然返回空列表，这很可能是当前问题的直接原因。

2. 排查API调用的参数问题 #

确保你的search和next_Page_Search函数里的API请求参数完全正确：

• 必须包含part=snippet（这是API要求的必填参数，没有的话请求会直接失败）
• 合理设置maxResults（取值范围是1-50，设为0的话肯定返回空）
• 如果指定了type参数（比如type=video），先确认你的搜索词在该类型下有结果，可以暂时去掉type参数测试

3. 检查API配额是否耗尽 #

YouTube Data API有每日配额限制（默认是10000单位），如果当天配额用完了，API会返回空结果或者直接报错。你可以登录Google Cloud Console，找到YouTube Data API v3的配额面板，查看剩余配额情况。

4. 确认nextPageToken的有效性 #

nextPageToken不是永久有效的，它只能用于紧接着的下一页请求，而且不能跨会话长时间保存。如果你的分页请求间隔太久，token会失效，导致返回空数组。建议在获取到token后立即发起下一页请求。

5. 给Promise链加上错误处理 #

你的代码没有catch块，API请求出错时（比如token无效、参数错误、密钥失效）不会被捕获，看起来像是返回空数组，但其实是请求失败了。一定要加上错误处理，方便快速排查问题。

修正后的代码示例 #

这里给你一个完善后的代码模板，包含错误处理和分页判断逻辑：

const search_this_q = "cats";
const API_KEY = "你的API密钥"; // 替换成你的有效API密钥

// 封装基础搜索函数
function search(query) {
  const url = `https://www.googleapis.com/youtube/v3/search?part=snippet&q=${encodeURIComponent(query)}&key=${API_KEY}&maxResults=10`;
  return fetch(url)
    .then(res => {
      if (!res.ok) throw new Error(`请求失败，状态码：${res.status}`);
      return res.json();
    });
}

// 封装分页搜索函数
function next_Page_Search(pageToken, query) {
  const url = `https://www.googleapis.com/youtube/v3/search?part=snippet&q=${encodeURIComponent(query)}&key=${API_KEY}&maxResults=10&pageToken=${encodeURIComponent(pageToken)}`;
  return fetch(url)
    .then(res => {
      if (!res.ok) throw new Error(`请求失败，状态码：${res.status}`);
      return res.json();
    });
}

function load() {
  search(search_this_q)
    .then(firstPageData => {
      console.log("第一页结果：", firstPageData);
      // 先判断是否有下一页token
      if (!firstPageData.nextPageToken) {
        console.log("没有更多分页数据");
        return Promise.resolve(null);
      }
      return next_Page_Search(firstPageData.nextPageToken, search_this_q);
    })
    .then(secondPageData => {
      if (!secondPageData) return;
      console.log("第二页结果：", secondPageData);
      if (!secondPageData.nextPageToken) {
        console.log("没有更多分页数据");
        return Promise.resolve(null);
      }
      return next_Page_Search(secondPageData.nextPageToken, search_this_q);
    })
    .then(thirdPageData => {
      if (!thirdPageData) return;
      console.log("第三页结果：", thirdPageData);
    })
    .catch(error => {
      console.error("请求过程出错：", error.message);
    });
}

load();

额外排查步骤 #

• 直接在浏览器地址栏里访问分页请求的URL，手动传入nextPageToken，看返回结果是否正常，排除代码封装的问题
• 确认你的API密钥已经启用了YouTube Data API v3（在Google Cloud Console的API库中检查）
• 尝试去掉regionCode或relevanceLanguage这类地区/语言过滤参数，看是否有结果返回

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