Python网络异常分连接类、请求类、响应类三类，按“建连→发请求→收响应”顺序排查最有效：连接类如ConnectionRefusedError、TimeoutError、gaierror；请求类如InvalidURL、MissingSchema；响应类需调用raise_for_status()触发HTTPError。
Python网络异常主要分三类：连接类、请求类、响应类，每类对应不同阶段的失败原因，定位时按“建连→发请求→收响应”顺序排查最有效。
连接类异常（ConnectionError 及其子类）
发生在建立TCP连接阶段，典型如无法到达目标服务器。常见具体异常包括 red">ConnectionRefusedError（服务未启动或端口关闭）、TimeoutError（连接超时）、gaierror（DNS解析失败）。
- 检查目标URL的协议、域名、端口是否正确，例如
http://localhost:8080中端口是否与服务实际监听一致 - DNS问题可尝试用
ping 域名或nslookup 域名验证；本地开发时优先用127.0.0.1替代localhost避免IPv6解析干扰 - 连接超时建议显式设置
timeout参数，如requests.get(url, timeout=5)，避免无限等待
请求类异常（RequestException 的非连接/响应子类）
多由客户端构造错误引发，不涉及网络传输失败。典型有 InvalidURL（URL格式非法）、MissingSchema（缺少 http:// 或 https://）、TooManyRedirects（重定向循环）。
- 拼接URL时务必校验协议头，可用
urllib.parse.urlparse()提前检查.scheme是否为http或https - 动态生成URL时，对用户输入或配置项做白名单过滤，避免注入空格、控制字符等非法内容
- 遇到重定向异常，可临时设
allow_redirects=False查看原始响应状态码，再判断是否需调整逻辑
响应类异常（HTTPError 及状态码相关）
请求已发出且收到服务器响应，但状态码表明异常（如4xx/5xx）。注意：requests 默认不会主动抛出异常，需手动调用 response.raise_for_status() 触发 HTTPError。
- 不要仅依赖
response.status_code == 200判断成功，有些API用201、204等也属正常响应 - 对400类错误，优先检查请求头（如
Content-Type）、请求体（JSON字段缺失/类型错误）、认证信息（token过期或权限不足） - 500类错误通常需查服务端日志，客户端可记录完整请求参数和响应头（
response.headers），便于协同排查
其他易忽略但高频的问题
不属于标准异常分类，但实践中常导致“看似网络异常”的表现：
-
SSL证书验证失败：报错含
SSLError或CertificateError，生产环境不应设verify=False，而应更新系统CA证书或指定正确证书路径 -
编码与解码异常：如
UnicodeDecodeError在读取响应文本时出现，说明服务器返回了非UTF-8编码内容，需用response.content.decode('gbk')等适配 -
代理配置错误：使用
proxies参数时，确保代理地址可达且协议匹配（http代理不能用于https请求除非支持CONNECT）
