Loguru项目中如何捕获Python标准警告日志

在Python开发过程中，我们经常使用标准库中的warnings模块来发出警告信息。这些警告对于调试和问题排查非常有价值，但默认情况下它们只会输出到控制台而不会被记录到日志文件中。本文将介绍如何在使用Loguru日志库时，同时捕获这些标准警告信息。

问题背景

Python开发者通常面临一个选择：是使用标准的warnings.warn()方法发出警告，还是使用日志系统记录警告信息。理想情况下，我们希望两者能够协同工作，既能在控制台看到警告，又能将这些警告信息持久化到日志文件中。

解决方案

Loguru提供了灵活的机制来捕获标准警告。核心思路是通过重写warnings模块的showwarning函数，在保持原有警告行为的同时，将警告信息转发给Loguru的日志系统。

具体实现代码如下：

import warnings
from loguru import logger

# 保存原始的showwarning函数
original_showwarning = warnings.showwarning

def custom_showwarning(message, *args, **kwargs):
    # 使用Loguru记录警告
    logger.warning(message)
    # 调用原始函数保持标准警告行为
    original_showwarning(message, *args, **kwargs)

# 替换默认的showwarning实现
warnings.showwarning = custom_showwarning

实现原理

Python的warnings模块在发出警告时，最终会调用showwarning函数来处理警告信息的显示。通过替换这个函数，我们可以在警告信息被显示前拦截它，并将其发送到Loguru的日志系统中。

这种方法的优势在于：

1. 完全兼容现有的warnings.warn()调用
2. 不影响警告的原始行为（仍然会在控制台显示）
3. 无需修改现有代码即可实现警告日志的记录

进阶用法

对于更复杂的需求，我们可以进一步定制警告处理逻辑：

def enhanced_showwarning(message, category, filename, lineno, file=None, line=None):
    # 格式化更详细的警告信息
    log_message = f"{filename}:{lineno} - {category.__name__}: {message}"
    logger.warning(log_message)
    # 保持原始警告行为
    original_showwarning(message, category, filename, lineno, file, line)

warnings.showwarning = enhanced_showwarning

这个增强版本可以记录警告发生的文件名、行号和警告类别，为后续的问题排查提供更多上下文信息。

注意事项

1. 建议在程序初始化时就设置好警告捕获，避免遗漏早期发出的警告
2. 注意线程安全性，特别是在多线程环境中
3. 考虑性能影响，虽然Loguru性能很好，但在高频警告场景仍需注意

通过这种集成方式，开发者可以充分利用Python标准警告机制和Loguru强大的日志功能，实现更完善的应用程序监控和问题诊断能力。