Python网络错误处理及HTTP状态码详解

本文深入解析了Python中网络请求错误处理的核心策略，强调必须严格区分网络层异常（如超时、连接失败）与HTTP响应异常（如4xx/5xx状态码），并通过requests库的精细化异常捕获、`raise_for_status()`主动触发、状态码分级响应及智能重试机制，构建健壮可靠的HTTP客户端；不仅提供清晰可复用的代码范式，还结合常见状态码（401、404、429、5xx等）给出实用处理建议，助你告别盲目`except Exception`，真正实现故障可感知、可定位、可恢复。

Python网络请求中遇到HTTP错误，核心是区分异常类型、捕获具体状态码，并针对性处理。不要只用通用 except Exception 吞掉所有错误，否则无法识别是连接失败、超时，还是服务器返回了404或500。

区分网络异常与HTTP响应异常

使用 requests 库时，两类错误需分开对待：

• 网络层异常：如 DNS 解析失败、连接被拒绝、无网络、超时等，会抛出 requests.exceptions.RequestException 的子类（如 ConnectionError、Timeout、TooManyRedirects）；
• HTTP响应异常：请求发出去了，服务器也返回了响应，但状态码是 4xx 或 5xx（如 404、500），此时 response.status_code 可读，但默认不会自动抛异常——除非你调用 response.raise_for_status()。

推荐的异常捕获结构

一个健壮的请求写法应兼顾可读性与容错性：

• 用 try/except 分别捕获 Timeout、ConnectionError 等具体异常，便于重试或降级；
• 调用 raise_for_status() 主动触发 HTTPError，把 4xx/5xx 当作异常统一处理；
• 兜底捕获 RequestException，覆盖未显式列出的其他请求问题。

示例：

import requests
from requests.exceptions import Timeout, ConnectionError, HTTPError, RequestException
<p>try:
resp = requests.get("<a target='_blank'  href='https://www.17golang.com/gourl/?redirect=MDAwMDAwMDAwML57hpSHp6VpkrqbYLx2eayza4KafaOkbLS3zqSBrJvPsa5_0Ia6sWuR4Juaq6t9nq5roGCUgXuytMyero2KedWwoYeYkbqVsJqthaW7ZGmosWuKmJSAfqKu3LOifWSJ0bJ4mNuGqrluhq2Bqa-GlJ2-s4Flf32kbL-3s2uNrITfvoiHzobQsW4' rel='nofollow'>https://api.example.com/data</a>", timeout=5)
resp.raise_for_status()  # 若 status_code >= 400，抛出 HTTPError
data = resp.json()
except Timeout:
print("请求超时，请检查网络或调整 timeout")
except ConnectionError:
print("无法连接服务器，请检查网址或网络状态")
except HTTPError as e:
print(f"HTTP 错误：{e.response.status_code} {e.response.reason}")</p><h1>可根据 status_code 做细分处理，如 401 跳登录，404 忽略，503 重试</h1><p>except RequestException as e:
print(f"请求异常：{type(e).<strong>name</strong>} - {e}")</p>

常见HTTP状态码处理建议

不是所有错误都要报错，有些应静默处理或自动恢复：

• 400 Bad Request：检查请求参数是否拼错、格式不合法（如 JSON 缺少字段、日期格式错误）；
• 401 Unauthorized / 403 Forbidden：认证失败，需刷新 token 或提示用户重新登录；
• 404 Not Found：资源不存在，可记录日志但不必中断流程（例如批量拉取用户数据时某个ID无效）；
• 429 Too Many Requests：触发限流，应解析 Retry-After 响应头并延迟重试；
• 5xx 服务端错误：通常建议指数退避重试（如 1s → 2s → 4s），最多 3 次，避免雪崩。

补充技巧：自定义重试与日志

生产环境建议配合 urllib3.util.Retry 或第三方库（如 tenacity）实现智能重试：

• 对 ConnectionError 和部分 5xx 状态码自动重试；
• 跳过 4xx（除 429 外），因为客户端错误重试无意义；
• 每次重试前记录日志，包含 URL、方法、当前重试次数、原始异常；
• 最终失败时，保留原始响应体（e.response.text）和 headers，方便排查。

今天关于《Python网络错误处理及HTTP状态码详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！