Python调用API失败时，应依次检查网络连通性、请求构造（URL/方法/参数）、响应状态码与内容、认证授权配置；每步均有典型错误和验证方法，可快速定位问题。
Python 调用 API 失败时，别急着重写代码，先按顺序检查这几个关键环节——网络、请求构造、响应处理、认证授权，多数问题都能快速定位。
检查网络连通性与基础访问
确保 Python 进程能正常访问目标服务器。最简单的验证方式是用 requests.get() 发起一个不带参数的 GET 请求，例如：
- 尝试访问公开健康端点：requests.get("https://httpbin.org/get")
- 若报 ConnectionError 或超时，说明是 DNS、代理、防火墙或目标服务不可达问题
- 确认是否用了公司内网/代理：需在 requests 中显式设置 proxies 参数，或检查环境变量 HTTP_PROXY/HTTPS_PROXY
核对请求方法、URL 和参数格式
很多失败源于“看起来对，其实错”：
- URL 是否拼写错误？特别注意协议（https://）、末尾斜杠、路径大小写（如 /api/v1/users ≠ /api/v1/Users）
- 接口要求 POST 但你用了 GET，或该传 JSON 却用了 params（拼在 URL 上），该传表单却没设 headers={"Content-Type": "application/x-www-form-urlencoded"}
- 查询参数（params）、请求体（json= 或 data=）、请求头（headers）三者职责不同，混用必出错
解析响应状态码和错误信息
不要只看有没有异常，要读 response.status_code 和 response.text：
立即学习“Python免费学习笔记（深入）”；
- 4xx 错误：客户端问题，比如 400（参数格式错）、401（token 过期）、403（权限不足）、404（路径不存在）
- 5xx 错误：服务端问题，可稍后重试，或联系 API 提供方
- 即使 status_code 是 200，也要检查响应体是否含 "error" 字段（有些 API 习惯用 200 包裹业务错误）
- 加一句 print(response.status_code, response.headers.get("Content-Type"), response.text[:200]) 能省大量时间
验证认证凭证与权限配置
Token、API Key、OAuth 等认证机制极易出错：
- 检查 token 是否过期（对比生成时间和 exp 字段）、是否复制漏字符、是否多加空格
- 确认请求头字段名正确：常见有 Authorization: Bearer xxx、X-API-Key: xxx、Api-Token: xxx，大小写和前缀都不能错
- 某些平台需在控制台为 key 显式开启对应 API 权限（如 GitHub 的 scopes、阿里云 RAM 子账号策略）
- 避免硬编码密钥，改用环境变量：os.getenv("API_TOKEN")，并确认运行环境已加载
