讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

剧云
剧云

中文短剧剧本制作平台

Python 网络异常处理的通用模式

千辰君_8573

千辰君_8573

发布时间:2026-01-30 19:50:37

|

688人浏览过

|

来源于php中文网

原创

requests 请求异常需分层捕获:先处理 socket.gaierror 等网络层异常,再捕获 requests.exceptions.Timeout、ConnectionError 等,最后用 raise_for_status() 处理 4xx/5xx 状态码。

python 网络异常处理的通用模式

捕获 requests 请求失败的常见异常类型

requests 库发起 HTTP 请求时,不会把所有错误都抛成 requests.exceptions.RequestException 的子类,实际中容易漏掉底层网络层异常。比如 DNS 解析失败会抛 socket.gaierror,连接超时是 requests.exceptions.Timeout,而服务端返回 4xx/5xx 状态码却不会触发异常——除非你显式调用 response.raise_for_status()。

  • requests.exceptions.Timeout:请求在指定 timeout 内未收到响应(含连接和读取两阶段)
  • requests.exceptions.ConnectionError:DNS 失败、拒绝连接、SSL 握手失败等底层连接问题
  • requests.exceptions.TooManyRedirects:重定向超过默认 30 次限制
  • requests.exceptions.RequestException:所有 requests 异常的基类,可兜底但不推荐单独捕获它来掩盖具体问题

示例中不要只写 except Exception:,否则会吞掉 KeyboardInterrupt 或 SystemExit,干扰调试和脚本退出逻辑。

为什么不能只靠 try/except 包裹 response.raise_for_status()

很多初学者以为只要捕获 raise_for_status() 抛出的异常就够了,但这是错觉。这个方法只检查 HTTP 状态码是否为 4xx/5xx,完全不管网络是否通、证书是否有效、响应体是否为空或 JSON 是否合法。

  • 如果服务器返回 200 但响应体是空字符串,response.json() 会抛 json.JSONDecodeError
  • 如果用了 verify=False 绕过 SSL 验证,可能遇到 requests.exceptions.SSLError(尤其在旧系统 OpenSSL 版本下)
  • 如果设置了 stream=True,但没消费完响应流就退出,可能引发连接复用异常或资源泄漏

真正健壮的处理要分层:先保连接通(网络异常),再保状态可用(HTTP 状态),最后保数据可用(解析与业务校验)。

立即学习“Python免费学习笔记(深入)”;

Technitium DNS
Technitium DNS

通过 HTTP API 监控和检查 Technitium DNS服务器。仅用于只读健康检查、DNS 统计、区域、DHCP 租约、令牌/会话验证及专业功能...

下载

重试 + 指数退避的实际写法(不用第三方库)

requests 本身不带重试机制,但标准库 urllib3 提供了 Retry 类,可直接注入到 Session 中。手动实现简单重试时,注意别用固定间隔(如 sleep(1)),否则可能触发服务端限流或雪崩。

  • 使用 urllib3.util.retry.Retry 可精确控制哪些状态码/异常触发重试(比如只重试 ConnectionError 和 502/503/504)
  • backoff_factor 参数决定指数退避基数:第一次重试延迟 backoff_factor * (2^(retry_number - 1)) 秒
  • 注意设置 respect_retry_after_header=True,让客户端遵守服务端返回的 Retry-After 头
from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry

session = requests.Session()
retry_strategy = Retry(
    total=3,
    status_forcelist=(502, 503, 504),
    backoff_factor=1,
    allowed_methods=frozenset(['HEAD', 'GET', 'OPTIONS', 'POST']),
)
adapter = HTTPAdapter(max_retries=retry_strategy)
session.mount("http://", adapter)
session.mount("https://", adapter)

超时设置必须拆成 connect 和 read 两部分

只设一个全局 timeout=5 看似简洁,但实际掩盖了两类完全不同的问题:

  • connect 超时:TCP 连接建立耗时过长(DNS 查询、SYN 重传、防火墙拦截等)
  • read 超时:连接已建好,但服务端迟迟不发响应或发送中断(如慢查询、挂起)

生产环境建议显式分开:

  • connect 超时设短(如 3–5 秒),因为连接失败通常意味着服务不可达或网络配置错误
  • read 超时可稍长(如 10–30 秒),尤其对上传文件或导出报表类接口

如果共用一个值,在高延迟网络下可能误判“连接失败”,而在服务端卡死时又无法及时中断。

真正难处理的是那些既不超时也不返回的“半开连接”——这时候需要依赖操作系统级别的 TCP keepalive,Python 层面无法直接控制,得靠 socket.setsockopt 或改用异步方案(如 aiohttp)。

热门AI工具

更多
PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2295

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3762

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1256

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4359

2025.09.10

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2295

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3762

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1256

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4359

2025.09.10

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

60

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn