Python中web错误处理与异常捕获示例详解

 更新时间:2025年07月11日 09:59:23   作者:伤不起bb  
在任何编程语言中,异常(Exception)都是一种不可避免的现象,它们通常是由程序运行时的错误或意外情况引起的,这篇文章主要介绍了Python中web错误处理与异常捕获的相关资料,需要的朋友可以参考下

一、概述

在 Web 开发中,错误处理与异常捕获是保障服务稳定性和用户体验的核心机制:

  • 核心目标

    • 防止服务崩溃:捕获未处理的异常,避免因单个请求错误导致整个服务不可用。

    • 友好用户提示:向客户端返回有意义的错误信息(如 404 页面、500 错误页)。

    • 日志记录:记录异常堆栈信息,便于调试和问题追踪。

  • 常见场景

    • 数据库操作失败(如连接超时、SQL 语法错误)。

    • 外部 API 调用异常(如网络中断、响应格式错误)。

    • 用户输入校验失败(如参数缺失、类型不匹配)。

  • HTTP 错误码关联

    • 4xx:客户端错误(如 400 Bad Request404 Not Found)。

    • 5xx:服务端错误(如 500 Internal Server Error)。

核心原则

  • 防崩溃:捕获所有未处理异常,避免服务中断。

  • 明日志:记录异常堆栈,便于调试。

  • 友好响应:返回用户易懂的错误信息,隐藏敏感细节。

二、try 语句

try 语句是 Python 中处理异常的基础工具,在 Web 开发中用于保护可能出错的代码块。

1.基础语法

try:  
    # 可能引发异常的代码(如数据库操作、文件读写)  
    risky_operation()  
except ExceptionType as e:  
    # 捕获特定异常并处理  
    handle_error(e)  
else:  
    # 无异常时执行(可选)  
    clean_up()  
finally:  
    # 无论是否异常都执行(如释放资源)  
    release_resources()  
代码块用途执行条件最佳实践
try包裹可能引发异常的代码总是执行仅包含可能出错的代码,避免冗余逻辑。
except捕获并处理特定异常当 try 块发生异常时优先捕获具体异常类型,避免裸露的 except
else执行无异常时的后续逻辑try 块无异常时执行用于分离正常流程和异常处理代码。
finally无论是否异常都执行的清理操作总是执行释放资源(如关闭文件、数据库连接)。

常见异常类型

异常触发场景
FileNotFoundError文件不存在时尝试读取(如 open("r"))。
PermissionError无权限访问文件(如只读文件尝试写入)。
IsADirectoryError尝试以文件模式操作目录。
UnicodeDecodeError文本文件编码不匹配(如用 utf-8 读取 gbk 文件)。

一句话总结

try 防崩溃,except 抓异常,else 走正路,finally 清战场。

2. 示例:捕获常见异常

import requests
from requests.exceptions import RequestException, Timeout, HTTPError

try:
    #发送 GET 请求,并设置超时时间为 5 秒
    response = requests.get('https://www.example.com', timeout=5)
    
    #如果状态码不是 200, 抛出 HTTPError 异常
    response.raise_for_status ()      # 如果状态码是 404 或 500, 抛出异常
    
    #如果请求成功,则输出响应内容
    print('Response Body:', response.text)
   
     #捕获请求超时异常
    except Timeout:
        print('Request timed out')
    #捕获 HTTP 错误 (如状态码 404、500 等)
    except HTTPError as http_err:
        print(f'HTTP error occurred: {http_err}')
    
    #捕获其他网络相关的错误
    except RequestException as req_err:
        print(f'Request error occurred: {req_err}')
    #可以在 finally 块中清理资源 (如关闭文件或连接)
    finally:
        print('Request attempt completed.')

代码解释: 

  1. try 块:首先发起 HTTP 请求,设置超时时间为 5 秒,并使用 response.raise_for_status () 来检查响应的状态码。如果服务器返回了错误的状态码 (如 404、500), raise_for_status () 会抛出 HTTPError 异常。
  2. except 块:
    • Timeout: 如果请求超时 (超过设置的 5 秒), 程序会捕获到 Timeout 异常,并打印 “Request timed out”。
    • HTTPError: 如果响应的状态码表明出现 HTTP 错误 (例如 404 表示未找到页面), 程序会捕获到 HTTPError 异常,并打印相关错误信息。
    • RequestException: 捕获其他类型的网络相关错误 (如连接问题、DNS 解析失败等)。RequestException 是所有 requests 库异常的基类,可以捕获任何 requests 库抛出的异常。
  3. finally 块: finally 中的代码无论是否发生异常都会被执行,通常用于释放资源或做一些收尾工作。”Request attempt completed“   表示请求结束

常见问题解决方案

问题解决方案代码示例
数据库连接泄漏使用 contextlib 管理连接with database_connection() as conn:
CSRF/XSS攻击启用框架内置保护(如Django的csrf_token<form>{% csrf_token %}</form>
文件上传超限捕获 RequestEntityTooLarge 异常except RequestEntityTooLarge: ...
第三方API超时设置超时 + 重试机制requests.get(url, timeout=5)

总结

场景工具/方法
代码块级错误处理try-except + 具体异常类型捕获
全局异常统一响应框架错误处理器(如 @errorhandler
自定义错误类型继承 Exception 定义业务异常类
日志记录logging 模块记录堆栈信息
异步错误处理asyncio 任务 + 异常回调

到此这篇关于Python中web错误处理与异常捕获的文章就介绍到这了,更多相关Python web错误处理内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Jupyter Notebook调用指定的虚拟环境的实现示例

    Jupyter Notebook调用指定的虚拟环境的实现示例

    本文主要介绍了Jupyter Notebook调用指定的虚拟环境的实现示例,,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-07-07
  • Python黑魔法Descriptor描述符的实例解析

    Python黑魔法Descriptor描述符的实例解析

    与迭代器和装饰器等一样,描述符也是Python编程中的一项高级技巧,这里我们就来讲解Python黑魔法Descriptor描述符的实例解析:
    2016-06-06
  • 一文教你解决Python不支持中文路径的问题

    一文教你解决Python不支持中文路径的问题

    Python是一种广泛使用的高级编程语言,然而在处理包含中文字符的文件路径时,Python有时会表现出一些不友好的行为,下面小编就来为大家介绍一下具体的解决方法吧
    2025-03-03
  • Pandas中的unique()和nunique()区别详解

    Pandas中的unique()和nunique()区别详解

    Pandas中Series和DataFrame的两种数据类型中都有nunique()和unique()方法,本文详细的介绍了两者的区别,具有一定的参考价值,感兴趣的可以了解一下
    2022-08-08
  • python打开windows应用程序的实例

    python打开windows应用程序的实例

    今天小编就为大家分享一篇python打开windows应用程序的实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-06-06
  • Python设计模式中的行为型策略模式

    Python设计模式中的行为型策略模式

    这篇文章主要介绍了Python设计模式中的行为型策略模式,策略模式即Strategy Pattern,其定义了算法家族,分别封装起来,让他们之间可以相互替换,此模式让算法的变化,不会影响到使用算法的客户,下文相关资料具有一点的参考价值,需要的小伙伴可以参考一下
    2022-02-02
  • Pytorch实现Fashion-mnist分类任务全过程

    Pytorch实现Fashion-mnist分类任务全过程

    这篇文章主要介绍了Pytorch实现Fashion-mnist分类任务全过程,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-12-12
  • python 等差数列末项计算方式

    python 等差数列末项计算方式

    这篇文章主要介绍了python 等差数列末项计算方式,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-05-05
  • python单例设计模式实现解析

    python单例设计模式实现解析

    这篇文章主要介绍了python单例设计模式实现解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-01-01
  • python如何使用split多字符分割字符串的方法

    python如何使用split多字符分割字符串的方法

    这篇文章主要给大家介绍了关于python如何使用split多字符分割字符串的相关资料,split()方法是一个非常强大的工具,可以帮助我们轻松地分割字符串,需要的朋友可以参考下
    2023-10-10

最新评论