讲师中心 微信公众号
AI工具推荐 视频效率加速

Python 网络异常处理最佳实践

陌墨同学_5418

陌墨同学_5418

发布时间:2026-02-27 18:10:03

|

1054人浏览过

|

来源于php中文网

原创

Python网络请求异常处理核心是精准捕获、区分错误类型、分设连接与读取超时、对临时错误指数退避重试、记录完整上下文日志。

python 网络异常处理最佳实践

Python 网络请求出错很常见,关键不是避免异常,而是让异常可预测、可捕获、可恢复。核心原则是:明确捕获具体异常、区分临时性与永久性错误、设置合理重试与超时、不吞掉异常信息。

只捕获你准备处理的网络异常

用 requests 或 urllib 时,不要写 except Exception: —— 这会掩盖编程错误(比如变量名写错)或系统级问题(如内存不足)。应精准捕获网络相关异常:

  • requests.exceptions.Timeout:连接或读取超时,通常可重试
  • requests.exceptions.ConnectionError:DNS失败、拒绝连接、网络断开等,多数属临时故障
  • requests.exceptions.HTTPError:状态码非 2xx(如 404、503),需按状态码逻辑判断——4xx 一般不重试,5xx 可考虑重试
  • requests.exceptions.RequestException:作为顶层基类,仅在兜底日志记录时使用,不用于业务逻辑分支

为超时设两道防线:连接 + 读取

只设一个总超时(如 timeout=10)不够健壮。网络卡在建连阶段(DNS解析、TCP握手)和卡在响应阶段(服务端慢、大文件传输)性质不同,应分开控制:

Python Hardener
Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖,强化 Python 脚本。

下载
  • 连接超时(connect timeout)建议 3–5 秒:DNS 和 TCP 建连本该很快,超时说明下游不可达或防火墙拦截
  • 读取超时(read timeout)视业务而定,通常 10–30 秒:允许服务端有合理处理时间,但防无限等待
  • 示例:requests.get(url, timeout=(3.5, 20)) 表示 3.5 秒内必须连上,连上后最多等 20 秒收完响应

对临时性错误做带退避的重试

ConnectionError 和 Timeout 多数是瞬时问题,重试有效;但盲目重试会加重服务压力。推荐用指数退避(exponential backoff):

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

  • 首次失败后等 1 秒,再失败等 2 秒,再失败等 4 秒……上限建议 10 秒内
  • 限制总重试次数(如最多 3 次),避免雪球效应
  • 用 tenacity 库最省心:@retry(stop=stop_after_attempt(3), wait=wait_exponential(multiplier=1, min=1, max=10))
  • 注意:重试前检查是否已产生副作用(如 POST 已提交订单),幂等性设计比重试更重要

记录足够上下文,方便定位真实原因

捕获异常时,别只打 print(e)。至少记录:

  • 请求 URL、HTTP 方法、关键参数(脱敏后)
  • 异常类型 + 完整 traceback(用 logging.exception())
  • 如果响应已收到(如 status_code=503),记下状态码和响应头(如 X-RateLimit-Remaining)
  • 对调试友好的日志级别:ConnectionError 和 Timeout 用 WARNING,HTTPError 中的 4xx 用 INFO,5xx 用 ERROR

热门AI工具

更多
SkildArt
SkildArt Hot

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

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

WorkBuddy

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

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

豆包大模型

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

DeepSeek

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

Flowith
Flowith Hot

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

相关专题

更多
python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

3360

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

269

2026.02.03

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1049

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3400

2023.10.25

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3963

2023.11.09

http请求415错误怎么解决
http请求415错误怎么解决

解决方法:1、检查请求头中的Content-Type;2、检查请求体中的数据格式;3、使用适当的编码格式;4、使用适当的请求方法;5、检查服务器端的支持情况。更多http请求415错误怎么解决的相关内容,可以阅读下面的文章。

974

2023.11.14

HTTP 503错误解决方法
HTTP 503错误解决方法

HTTP 503错误表示服务器暂时无法处理请求。想了解更多http错误代码的相关内容,可以阅读本专题下面的文章。

6806

2024.03.12

http与https有哪些区别
http与https有哪些区别

http与https的区别:1、协议安全性;2、连接方式;3、证书管理;4、连接状态;5、端口号;6、资源消耗;7、兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

5530

2024.08.16

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

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

0

2026.11.06

热门下载

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

精品课程

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

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