调用GitHub API搜索用户仅返回单个结果的问题咨询

返回结果仅1条通常由以下几个问题导致：

• 参数拼接错误或被截断：如果未对用户输入的内容做URL编码，输入内容携带&、?等URL特殊字符时，会被接口识别为独立的请求参数，最常见的情况是意外拼出per_page=1参数，强制接口仅返回单条结果。另外如果in:login type:user限定条件没有和用户名关键词正确拼接，会导致查询逻辑不符合预期。
• 代码取值逻辑错误：接口返回的匹配用户列表存放在items数组字段中，total_count是全量匹配结果的总数，如果代码中直接取items[0]单条数据渲染，会误以为接口只返回了1个结果。
• 默认参数被篡改：GitHub搜索接口默认单页返回30条结果，如果你使用的请求封装、拦截器默认给请求加上了per_page=1参数，就会出现单结果返回的情况。
• 匹配规则理解偏差：接口会将login完全匹配搜索词的账号放在返回列表第一位，但不会过滤其他相似匹配结果，如果只读取第一条数据，会误以为没有其他匹配项。

按以下步骤排查即可解决：

1. 打印实际发起请求的完整URL，确认参数格式正确。用户输入的内容必须先经过encodeURIComponent转义，再拼接搜索限定条件，避免特殊字符截断参数。正确的前端请求写法参考：

const fetchGithubUsers = async (username) => {
  // 转义用户输入后拼接查询规则
  const searchQuery = `${encodeURIComponent(username)} in:login type:user`
  const resp = await fetch(`https://api.github.com/search/users?q=${searchQuery}`)
  if (!resp.ok) throw new Error('请求失败')
  const result = await resp.json()
  // result.items 为当前页匹配的所有用户数组
  // result.total_count 为全量匹配的用户总数
  return result.items
}

2. 检查请求的query参数，确认没有被意外注入per_page=1。如果需要单页获取更多结果，可以手动追加per_page参数，取值范围为1-100，比如追加&per_page=100即可单页返回最多100条结果；如果总匹配数超过单页上限，通过page参数逐页获取即可。
3. 调整前端渲染逻辑，遍历items数组展示所有返回的用户，不要仅读取数组第一条数据。
4. 如果需要更精准的前缀模糊匹配效果，可以在搜索关键词后追加*通配符，比如用户输入oct时，查询词写为oct* in:login type:user，会匹配所有login以oct开头的用户，更符合用户名片段搜索的预期。

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