在 Python 中手动引发（引发）异常

如何在Python中手动抛出/引发异常？

使用语义上适合您的问题的最具体的异常构造函数。

在消息中要具体，例如：

raise ValueError('A very specific bad thing happened.')

不要引发一般异常

避免引发泛型 .要捕获它，您必须捕获所有其他对其进行子类化的更具体的异常。Exception

问题 1：隐藏错误

raise Exception('I know Python!') # Don't! If you catch, likely to hide bugs.

例如：

def demo_bad_catch():
    try:
        raise ValueError('Represents a hidden bug, do not catch this')
        raise Exception('This is the exception you expect to handle')
    except Exception as error:
        print('Caught this error: ' + repr(error))

>>> demo_bad_catch()
Caught this error: ValueError('Represents a hidden bug, do not catch this',)

问题2：无法捕获

更具体的捕获不会捕获一般异常：

def demo_no_catch():
    try:
        raise Exception('general exceptions not caught by specific handling')
    except ValueError as e:
        print('we will not catch exception: Exception')
 

>>> demo_no_catch()
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "<stdin>", line 3, in demo_no_catch
Exception: general exceptions not caught by specific handling

最佳实践：声明raise

相反，请使用语义上适合您的问题的最具体的 Exception 构造函数。

raise ValueError('A very specific bad thing happened')

这也方便地允许将任意数量的参数传递给构造函数：

raise ValueError('A very specific bad thing happened', 'foo', 'bar', 'baz') 

这些参数由对象上的属性访问。例如：argsException

try:
    some_code_that_may_raise_our_value_error()
except ValueError as err:
    print(err.args)

指纹

('message', 'foo', 'bar', 'baz')    

在Python 2.5中，添加了一个实际的属性，以鼓励用户子类异常并停止使用，但是消息的引入和args的原始弃用已被撤回。messageBaseExceptionargs

最佳实践：子句except

例如，在 except 子句中时，您可能希望记录发生了特定类型的错误，然后重新引发。在保留堆栈跟踪的同时执行此操作的最佳方法是使用裸 raise 语句。例如：

logger = logging.getLogger(__name__)

try:
    do_something_in_app_that_breaks_easily()
except AppError as error:
    logger.error(error)
    raise                 # just this!
    # raise AppError      # Don't do this, you'll lose the stack trace!

不要修改您的错误...但如果你坚持。

您可以使用 保留 堆栈跟踪 （和错误值）， 但这更容易出错，并且在 Python 2 和 3 之间存在兼容性问题，因此更喜欢使用 bare 来重新提升。sys.exc_info()raise

解释 - 返回类型、值和回溯。sys.exc_info()

type, value, traceback = sys.exc_info()

这是Python 2中的语法 - 请注意，这与Python 3不兼容：

raise AppError, error, sys.exc_info()[2] # avoid this.
# Equivalently, as error *is* the second object:
raise sys.exc_info()[0], sys.exc_info()[1], sys.exc_info()[2]

如果您愿意，您可以修改新加薪时发生的情况 - 例如，为实例设置新：args

def error():
    raise ValueError('oops!')

def catch_error_modify_message():
    try:
        error()
    except ValueError:
        error_type, error_instance, traceback = sys.exc_info()
        error_instance.args = (error_instance.args[0] + ' <modification>',)
        raise error_type, error_instance, traceback

我们在修改参数时保留了整个回溯。请注意，这不是最佳实践，并且在Python 3中是无效的语法（使保持兼容性变得更加困难）。

>>> catch_error_modify_message()
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "<stdin>", line 3, in catch_error_modify_message
  File "<stdin>", line 2, in error
ValueError: oops! <modification>

在 Python 3 中：

raise error.with_traceback(sys.exc_info()[2])

同样：避免手动操作回溯。它的效率较低且更容易出错。如果您使用的是线程，甚至可能得到错误的回溯（特别是如果您使用异常处理控制流 - 我个人倾向于避免这种情况）。sys.exc_info

Python 3， 异常链接

在Python 3中，您可以链接异常，这些异常保留了回溯：

raise RuntimeError('specific message') from error

请注意：

• 这确实允许更改引发的错误类型，并且
• 这与Python 2不兼容。

已弃用的方法：

这些可以很容易地隐藏甚至进入生产代码。你想提出一个异常，这样做会引发一个异常，但不是预期的异常！

在 Python 2 中有效，但在 Python 3 中无效，如下所示：

raise ValueError, 'message' # Don't do this, it's deprecated!

只有在更旧版本的Python（2.4及更低版本）中有效，您仍然可能会看到人们提出字符串：

raise 'message' # really really wrong. don't do this.

在所有现代版本中，这实际上会引发 一个 ，因为您没有引发类型。如果您没有检查正确的异常，并且没有知道该问题的审阅者，则它可能会投入生产。TypeErrorBaseException

用法示例

我提出异常来警告消费者我的API，如果他们使用不当：

def api_func(foo):
    '''foo should be either 'baz' or 'bar'. returns something very useful.'''
    if foo not in _ALLOWED_ARGS:
        raise ValueError('{foo} wrong, use "baz" or "bar"'.format(foo=repr(foo)))

在提议时创建自己的错误类型

“我想故意犯错误，这样它就会进入例外”

您可以创建自己的错误类型，如果要指示应用程序存在特定问题，只需在异常层次结构中的相应点进行子类化：

class MyAppLookupError(LookupError):
    '''raise this when there's a lookup error for my app'''

和用法：

if important_key not in resource_dict and not ok_to_be_missing:
    raise MyAppLookupError('resource is missing, and that is not ok.')

不要这样做。养一个裸露绝对不是正确的做法;看看Aaron Hall的精彩答案。Exception

它不能得到比这更多的Pythonic：

raise Exception("I know Python!")

替换为要引发的特定类型的异常。Exception

如果您想了解更多信息，请参阅Python的 raise 语句文档。