解决 Loguru 无法将错误信息输出到日志文件的问题-Python教程-PHP中文网

解决 Loguru 无法将错误信息输出到日志文件的问题

DDD

发布： 2025-10-19 11:20:21

原创

969人浏览过

解决 Loguru 无法将错误信息输出到日志文件的问题

<p>本文旨在解决 Python Loguru 库在特定情况下无法将错误信息正确输出到日志文件的问题。通过分析问题原因，解释了 Python 异常处理机制与 Loguru 的交互方式，并提供了使用 <code>@logger.catch</code> 装饰器捕获未处理异常并将其记录到所有配置的接收器的解决方案，确保所有错误信息都能被记录，从而方便问题排查。</p> 在使用 Loguru 进行日志记录时，有时会遇到这样的情况：常规日志可以同时输出到终端和日志文件，但错误信息（例如未捕获的异常）却只显示在终端，而没有写入日志文件。这通常是由于 Python 的异常处理机制与 Loguru 的工作方式之间存在差异导致的。 **问题分析** 当 Python 代码中发生未捕获的异常时，Python 解释器会通过 `sys.excepthook()` 函数来处理。默认情况下，`sys.excepthook()` 会将错误信息输出到 `sys.stderr`。然而，Loguru 默认情况下并不会自动捕获这些通过 `sys.excepthook()` 输出的错误信息。因此，虽然错误信息会显示在终端（因为终端通常会同时显示 `sys.stdout` 和 `sys.stderr` 的内容），但 Loguru 并不会将其写入日志文件。 **解决方案：使用 `@logger.catch` 装饰器** Loguru 提供了一个方便的装饰器 `@logger.catch`，可以用来捕获未处理的异常，并将其记录到所有配置的接收器（sinks）中。它的工作原理是在内部使用 `try / except` 语句来捕获异常，并将异常信息传递给 Loguru 的日志记录系统。 **使用方法示例** ```python from loguru import logger def divide(): try: 1 / 0 # 故意引发 ZeroDivisionError except Exception as e: logger.error(f"发生错误: {e}") raise # 重新抛出异常，以便后续处理 (可选) @logger.catch def main(): divide() if __name__ == "__main__": main()

在这个例子中，@logger.catch 装饰器被应用到 main() 函数上。当 divide() 函数中发生 zerodivisionerror 异常时，@logger.catch 会捕获这个异常，并使用 logger.error() 将错误信息记录到所有配置的接收器中（包括终端和日志文件）。

更完善的例子

from loguru import logger
import sys

logger.add("error.log", level="ERROR")
logger.add(sys.stderr, level="ERROR")

@logger.catch
def my_function(x, y):
    return x / y

if __name__ == "__main__":
    my_function(1,0)

登录后复制

注意事项

@logger.catch 装饰器应该应用于可能引发未处理异常的函数。通常，建议将其应用于程序的入口点函数（例如 main() 函数）。
如果需要在捕获异常后进行一些自定义处理（例如清理资源、发送通知等），可以在 try / except 块中添加相应的代码。如果需要将异常继续向上抛出，可以使用 raise 语句。
使用 @logger.catch 装饰器可以确保所有未处理的异常都被记录下来，从而方便问题的排查和调试。

总结

无涯·问知

无涯·问知，是一款基于星环大模型底座，结合个人知识库、企业知识库、法律法规、财经等多种知识源的企业级垂直领域问答产品

查看详情

通过使用 Loguru 的 @logger.catch 装饰器，可以有效地解决 Loguru 无法将错误信息输出到日志文件的问题。 @logger.catch 装饰器能够捕获未处理的异常，并将其记录到所有配置的接收器中，确保所有错误信息都被记录，从而方便问题的排查和调试。记住，在关键函数上使用 @logger.catch，尤其是程序入口点，能够极大地提高代码的健壮性和可维护性。

登录后复制

以上就是解决 Loguru 无法将错误信息输出到日志文件的问题的详细内容，更多请关注php中文网其它相关文章！