如何在Python中正确处理异常而不丢失回溯信息？

Question

我正在开发一个 Python 应用程序，我需要优雅地处理异常并记录有用的信息以进行调试。具体来说，我想捕获运行时发生的异常，但我还需要保留回溯信息（堆栈跟踪）以了解错误源自何处以及异常如何传播。

我知道Python提供了一个try- except块来捕获异常，但我想确保：

我正确地捕获并处理异常。 我记录了错误的完整回溯，而没有丢失任何关键的调试信息。 我仍然提供有意义的输出（可能对用户而言），同时记录所有相关信息以进行进一步调试。 我发现，当我使用简单的 except 块捕获异常时，有时完整的回溯会丢失或未正确记录。我想确保我可以以结构化的方式记录完整的堆栈跟踪，以便于调试。

我在代码中使用了基本的 try- except 块，但我不确定我是否有效地记录了回溯。 我尝试使用日志记录模块，但我不确定如何包含完整的回溯。 我知道可以使用traceback.format_exc()检索回溯，但我不清楚如何通过正确的日志记录来正确实现这一点。

我所做的示例（但它似乎没有记录所有内容）：

import logging

logging.basicConfig(level=logging.ERROR)

def risky_function():
    # Simulating an error
    x = 1 / 0

try:
    risky_function()
except Exception as e:
    logging.error("An error occurred: %s", e)

在上面的示例中，捕获了异常，并记录了一条错误消息，但日志中不包含完整的回溯信息。我需要在日志中保留并记录完整的回溯，以便更好地调试。

我在寻找什么： 有关如何在 Python 中正确捕获异常并使用日志记录模块或其他方法记录完整回溯的示例。 清晰解释如何结合使用回溯和日志记录来记录详细信息，包括错误消息和完整的堆栈跟踪。 记录异常的最佳实践，确保捕获异常消息和回溯而不丢失关键信息。

Answer 1

正确处理异常，同时保留 Python 中的回溯信息对于调试和理解错误的根本原因至关重要。以下是如何有效地做到这一点：

使用

try

-

except

与

traceback

模块

traceback

模块允许您检索和格式化异常的回溯：

import traceback

try:
    # Code that might raise an exception
    risky_operation()
except Exception as e:
    print("An error occurred:", e)
    print("Traceback details:")
    traceback.print_exc()

重新引发异常

如果捕获异常但仍希望其传播，请使用不带参数的

raise

来重新引发当前异常。这保留了原始的回溯：

try:
    risky_operation()
except Exception as e:
    print("Logging the exception before re-raising it:", e)
    raise  # Re-raises the same exception with its original traceback

在保留上下文的同时将

raise

与新异常一起使用

要在保留回溯的同时引发新异常，请使用

from

关键字。这明确地将新异常链接到原始异常：

try:
    risky_operation()
except ValueError as e:
    raise RuntimeError("A more descriptive error message") from e

使用日志记录进行回溯

logging

模块可以记录异常及其回溯，以便在生产环境中更好地监控和调试：

import logging

logging.basicConfig(level=logging.ERROR)

try:
    risky_operation()
except Exception as e:
    logging.error("Exception occurred", exc_info=True)  # Includes traceback

自定义异常处理

如果您有自定义异常类，则可以包含其他信息，同时保持回溯处理完整：

class CustomError(Exception):
    pass

try:
    risky_operation()
except Exception as e:
    raise CustomError("Custom error occurred") from e

总结

• 保留回溯：使用

  raise

  重新引发或

  raise ... from ...

  链接异常。
• 调试辅助：使用

  traceback.print_exc()

  进行交互式调试，或使用

  logging.error(..., exc_info=True)

  进行生产环境。
• 最佳实践：避免在没有充分理由的情况下抑制异常，因为这会使调试变得更加困难。始终有意义地记录或处理错误。