21.9. urllib.error — 由 urllib.request 引发的异常类 — Python 文档

21.9. urllib.error — 由 urllib.request 引发的异常类

源代码： :source:`Lib/urllib/error.py`

---

urllib.error 模块定义了由 urllib.request 引发的异常的异常类。 基本异常类是 URLError。

urllib.error 根据需要引发以下异常：

exception urllib.error.URLError

处理程序在遇到问题时会引发此异常（或派生异常）。 它是 OSError 的子类。

reason

这个错误的原因。 它可以是消息字符串或其他异常实例。

3.3 版更改：URLError 已成为 OSError 的子类，而不是 IOError。

exception urllib.error.HTTPError

尽管是一个异常（URLError 的子类），HTTPError 也可以作为一个非异常的类文件返回值（与 urlopen()[ X179X] 返回）。 这在处理奇异的 HTTP 错误时很有用，例如身份验证请求。

code

RFC 2616 中定义的 HTTP 状态代码。 此数值对应于在 http.server.BaseHTTPRequestHandler.responses 中找到的代码字典中找到的值。

reason

这通常是解释此错误原因的字符串。

headers

导致 HTTPError 的 HTTP 请求的 HTTP 响应标头。

3.4 版中的新功能。

exception urllib.error.ContentTooShortError(msg, content)

当 urlretrieve() 函数检测到下载的数据量小于预期量（由 Content-Length 标头给出）时，会引发此异常。 content 属性存储下载的（并且可能被截断的）数据。