InvalidSchema错误源于URL缺少http://或https://协议头,导致requests无法识别合法URL;应使用urllib.parse.urlparse检查scheme字段,无协议时默认补https://,避免盲目拼接或仅靠异常捕获处理。

requests 报 InvalidSchema: No connection adapters were found 是因为 URL 缺少协议头
这个错误本质是 requests 没法识别你传进去的字符串为合法 URL,比如传了 "example.com" 或 "api.example.com/v1/data" —— 它既不是 http:// 也不是 https:// 开头,requests 直接放弃处理,抛出 InvalidSchema。
怎么快速补全 http:// 或 https:// 前缀
别硬写字符串拼接,先判断是否已有协议头,再决定补什么。常见做法是用 urllib.parse.urlparse 检查 scheme 字段:
from urllib.parse import urlparse <p>def ensure_scheme(url): parsed = urlparse(url) if not parsed.scheme:</p><h1>默认补 https,更安全;若确定要 http,可改为 'http'</h1><pre class="brush:php;toolbar:false;"> return 'https://' + url return url
示例
print(ensure_scheme('github.com')) # https://www.php.cn/link/048517851c55e77cf9daf170c6fdd7ab print(ensure_scheme('https://www.php.cn/link/f9c3adf1303060c6e57a765820c6372a')) # https://www.php.cn/link/f9c3adf1303060c6e57a765820c6372a print(ensure_scheme('https://www.php.cn/link/9dff9ab17beb0a69734bac543900c536')) # https://www.php.cn/link/9dff9ab17beb0a69734bac543900c536
- 不要无脑加
http://:现在很多 API 只支持 HTTPS,加错协议会导致连接被拒绝或重定向失败 - 注意
urlparse对纯域名(如example.com)会把整个字符串当path,scheme为空,这是判断依据 - 如果 URL 已含用户信息、端口或路径(如
user@host:8080/path),直接拼https://会破坏结构,此时应先做基础校验或用更健壮的库如yarl
requests.get() 前必须做 URL 校验,不能依赖 try/except 吞掉 InvalidSchema
有人习惯写 try...except InvalidSchema 然后自动补前缀,这不可靠:
-
InvalidSchema还可能由其他非法字符触发(如空格、中文未编码、控制字符),盲目补协议会掩盖真实问题 - 错误发生在请求发起前,
requests根本没走网络层,catch 住也解决不了根本原因 - 批量调用时,一个坏 URL 导致整个逻辑流 fallback,调试成本远高于提前过滤
建议在构造请求前统一过一遍 ensure_scheme,并在日志里记录原始输入,方便追溯来源。
第三方库(如 httpx)也会遇到同样问题,但错误提示略有不同
httpx 遇到无协议 URL 会报 InvalidURL: URL has no scheme,原理一致。补全逻辑完全通用,但要注意:
-
httpx默认不自动跟随 HTTP → HTTPS 重定向,所以补https://更关键 - 某些内部服务用
http://localhost:3000,补成https://会连不上,需按环境区分策略(例如检查parsed.netloc是否含localhost或127.0.0.1) - 如果 URL 来自用户输入或配置文件,最好在加载阶段就做标准化,而不是每次请求都临时修复
协议头这事看着小,但漏掉一次,就可能让下游服务返回 301、400 甚至直接断连——尤其在微服务间调用或 CLI 工具里,URL 构造往往藏在多层封装后面,出问题时很难一眼定位。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











