python异常处理

---

title: python异常处理

异常概述

异常机制是衡量一个编程语言是否成熟的标准之一，使用异常处理机制的python程序容错性会更好。

什么是异常

• 在自动化脚本开发程中，往往会出现一些不可预知的错误,这种情况在编程语言中叫做异常。遇到异常，我们要处理它，不是等到异常发生的时候，让IDE帮你处理，等他给你抛出异常的时候，就晚了。当Python脚本发生异常时我们需要捕获处理它，否则程序会终止执行。
• python的异常机制主要依赖try、except、else、finally和raise五个关键字，其中在try关键字后缩进的代码块简称try块，它里面放置的是可能引发异常的代码

异常处理规则

• 异常处理目的
  1. 使程序代码混乱最小化
  2. 捕获并保留诊断信息
  3. 通知相关人员
  4. 采用合适的方法结束异常
• 异常处理规则
  1. 不要过度使用异常
     • 不要把异常和普通错误混淆在一起。不再编写任何错误处理代码，而是以简单地引发异常来代替所有的错误处理
     • 不要使用异常处理来代替正常的程序流程控制
  2. 不要使用庞大的try块
     • 把大块的 try 块分割成多个可能出现异常的程序段落，并把它们放在单独的 try块中，从而分别捕获并处理异常
  3. 不要忽略捕捉到的异常，可以对异常采取适当措施

常见的内置异常

AttributeError			/* 试图访问一个对象不存在的属性 */
IOError					/* 输入/输出异常 */
ImportError				/* 引入模块或包异常（路径问题或名称问题） */
IndentationError		/* 缩进错误 */
IndexError				/* 下标索引错误 */
KeyError				/* 所访问键值不存在 */
KeyboardInterrupt		/* Ctrl+C被按下（键盘终止输入） */
NameError				/* 使用未定义的变量 */
SyntaxError				/* 语法错误 */
TypeError				/* 传入对象的类型与要求的不符合 */
UnboundLocalError		/* 试图访问一个还未被设置的局部变量 */
ValueError				/* 传入一个调用者不期望的值 */

内置异常类的层次结构

BaseException  # 所有异常的基类
 +-- SystemExit  # 解释器请求退出
 +-- KeyboardInterrupt  # 用户中断执行(通常是输入^C)
 +-- GeneratorExit  # 生成器(generator)发生异常来通知退出
 +-- Exception  # 常规异常的基类
      +-- StopIteration  # 迭代器没有更多的值
      +-- StopAsyncIteration  # 必须通过异步迭代器对象的__anext__()方法引发以停止迭代
      +-- ArithmeticError  # 各种算术错误引发的内置异常的基类
      |    +-- FloatingPointError  # 浮点计算错误
      |    +-- OverflowError  # 数值运算结果太大无法表示
      |    +-- ZeroDivisionError  # 除(或取模)零 (所有数据类型)
      +-- AssertionError  # 当assert语句失败时引发
      +-- AttributeError  # 属性引用或赋值失败
      +-- BufferError  # 无法执行与缓冲区相关的操作时引发
      +-- EOFError  # 当input()函数在没有读取任何数据的情况下达到文件结束条件(EOF)时引发
      +-- ImportError  # 导入模块/对象失败
      |    +-- ModuleNotFoundError  # 无法找到模块或在在sys.modules中找到None
      +-- LookupError  # 映射或序列上使用的键或索引无效时引发的异常的基类
      |    +-- IndexError  # 序列中没有此索引(index)
      |    +-- KeyError  # 映射中没有这个键
      +-- MemoryError  # 内存溢出错误(对于Python 解释器不是致命的)
      +-- NameError  # 未声明/初始化对象 (没有属性)
      |    +-- UnboundLocalError  # 访问未初始化的本地变量
      +-- OSError  # 操作系统错误，EnvironmentError，IOError，WindowsError，socket.error，select.error和mmap.error已合并到OSError中，构造函数可能返回子类
      |    +-- BlockingIOError  # 操作将阻塞对象(e.g. socket)设置为非阻塞操作
      |    +-- ChildProcessError  # 在子进程上的操作失败
      |    +-- ConnectionError  # 与连接相关的异常的基类
      |    |    +-- BrokenPipeError  # 另一端关闭时尝试写入管道或试图在已关闭写入的套接字上写入
      |    |    +-- ConnectionAbortedError  # 连接尝试被对等方中止
      |    |    +-- ConnectionRefusedError  # 连接尝试被对等方拒绝
      |    |    +-- ConnectionResetError    # 连接由对等方重置
      |    +-- FileExistsError  # 创建已存在的文件或目录
      |    +-- FileNotFoundError  # 请求不存在的文件或目录
      |    +-- InterruptedError  # 系统调用被输入信号中断
      |    +-- IsADirectoryError  # 在目录上请求文件操作(例如 os.remove())
      |    +-- NotADirectoryError  # 在不是目录的事物上请求目录操作(例如 os.listdir())
      |    +-- PermissionError  # 尝试在没有足够访问权限的情况下运行操作
      |    +-- ProcessLookupError  # 给定进程不存在
      |    +-- TimeoutError  # 系统函数在系统级别超时
      +-- ReferenceError  # weakref.proxy()函数创建的弱引用试图访问已经垃圾回收了的对象
      +-- RuntimeError  # 在检测到不属于任何其他类别的错误时触发
      |    +-- NotImplementedError  # 在用户定义的基类中，抽象方法要求派生类重写该方法或者正在开发的类指示仍然需要添加实际实现
      |    +-- RecursionError  # 解释器检测到超出最大递归深度
      +-- SyntaxError  # Python 语法错误
      |    +-- IndentationError  # 缩进错误
      |         +-- TabError  # Tab和空格混用
      +-- SystemError  # 解释器发现内部错误
      +-- TypeError  # 操作或函数应用于不适当类型的对象
      +-- ValueError  # 操作或函数接收到具有正确类型但值不合适的参数
      |    +-- UnicodeError  # 发生与Unicode相关的编码或解码错误
      |         +-- UnicodeDecodeError  # Unicode解码错误
      |         +-- UnicodeEncodeError  # Unicode编码错误
      |         +-- UnicodeTranslateError  # Unicode转码错误
      +-- Warning  # 警告的基类
           +-- DeprecationWarning  # 有关已弃用功能的警告的基类
           +-- PendingDeprecationWarning  # 有关不推荐使用功能的警告的基类
           +-- RuntimeWarning  # 有关可疑的运行时行为的警告的基类
           +-- SyntaxWarning  # 关于可疑语法警告的基类
           +-- UserWarning  # 用户代码生成警告的基类
           +-- FutureWarning  # 有关已弃用功能的警告的基类
           +-- ImportWarning  # 关于模块导入时可能出错的警告的基类
           +-- UnicodeWarning  # 与Unicode相关的警告的基类
           +-- BytesWarning  # 与bytes和bytearray相关的警告的基类
           +-- ResourceWarning  # 与资源使用相关的警告的基类。被默认警告过滤器忽略。
 

基本语法结构

try:
    程序执行语句块
except Exception as alias:
    异常处理语句块
...
else:
    无异常时处理语句块
finally:
    必须的处理语句块

基础样例

"""
正常状态下，程序的退出码(exit code)为 0

"""

try:
    a = 10 / 0			# 此处异常，try包裹的剩下（两行）代码都不会执行，直接跳到对应的异常处理分支
    a = b + 1
    a = 2 + '2'
except (NameError, ZeroDivisionError) as e:
    print(type(e), e)
except TypeError as e:
    print(type(e), e)
except Exception as e:
    print(e)
else:
    print('else')
finally:
    print('finally')

raise 主动抛出异常

try:
    dct = {'a':1}
    inp = input("input a value:")
    if len(inp)>1 :
       raise ValueError('输入字符过长')		# 主动抛出一个异常，后面的except分支会进行捕获
    a = 2 / int(inp)
    a = dct[inp]
except (NameError, ZeroDivisionError) as e:
    print(type(e), e)
    raise						# raise不带参数且处于except块中，将会自动引发当前上下文激活的异常
        						# 否则，通常默认引发RuntimeError异常
except TypeError as e:
    print(type(e), e)
except Exception as e:
    print(e)
    raise KeyError('所访问键值不存在')		# 指明主动抛出的异常类型
else:
    print('else')
finally:
    print('finally')

自定义异常

"""自定义异常

"""
class TranError(Exception):
    def __init__(self, errCode=500, message='ranError'):
        self.errrorCode = errCode
        self.message = message
        
    def __str__(self):
        return f'[{self.errrorCode}]: {self.message}'
    

try:
    dct = {'a':1}
    inp = input("input a value:")
    if len(inp)>1 :
       raise TranError(505, "自定义异常")		# 主动抛出一个异常，后面的except分支会进行捕获
    a = 2 / int(inp)
    a = dct[inp]
except (NameError, ZeroDivisionError) as e:
    print(type(e), e)
    raise						# 不带参数，则抛出之前捕获到的异常，给调用者处理
except TypeError as e:
    print(type(e), e)
except Exception as e:
    print(e)
else:
    print('else')
finally:
    print('finally')
    

""" output
input a value:aa
[505]: 自定义异常
finally

Process finished with exit code 0
"""

参考链接

[1] 异常和程序调试

[2] python中的异常处理-上篇

[3] python中的异常处理-下篇