使用requests库的params参数调用GitHub API异常问题求助

DevOps 小满

2026-5-20

问题分析与解决方案

没错，URL中缺失q=正是导致你API调用失败的核心原因！

GitHub的各类搜索API（比如仓库搜索、代码搜索、议题搜索）都明确要求用q参数来传递你的搜索查询条件——API后端会依赖这个参数来解析你要执行的搜索请求，没有q=的话，API根本无法识别你的查询意图，自然会返回错误或者空的响应结果。

为什么用`params`会丢`q=`？

大概率是你构造params字典时，没有把搜索查询内容放在'q'这个指定的键下面。举个常见的错误示例：

# 错误写法：用了错误的键名，比如'query'
params = {'query': 'python stars:>1000'}

这种情况下，requests会把参数拼为?query=python+stars%3A%3E1000，完全不符合GitHub API的要求，自然会出错。

正确的解决方法

只需要把你的搜索查询内容放在params字典的'q'键下即可，requests会自动帮你生成包含q=的正确URL，还会自动处理特殊字符的URL编码（比手动拼接URL更安全）。

举个完整的正确示例：

import requests

# GitHub仓库搜索API的基础URL
base_url = 'https://api.github.com/search/repositories'

# 构造正确的params字典：查询条件放在'q'键下
search_params = {
    'q': 'python stars:>1000',  # 核心搜索条件
    'sort': 'stars',            # 可选：按星数排序
    'order': 'desc'             # 可选：降序排列
}

# 发送请求
response = requests.get(base_url, params=search_params)

# 处理响应
if response.ok:
    results = response.json()
    print(f"成功找到 {results['total_count']} 个符合条件的仓库")
else:
    print(f"请求失败，状态码：{response.status_code}，错误信息：{response.text}")

这样生成的URL会是：
https://api.github.com/search/repositories?q=python+stars%3A%3E1000&sort=stars&order=desc
和你手动拼接的正确URL完全一致，API调用也能正常工作。