Loguru项目中正确捕获警告信息的源位置问题

在Python开发中，日志记录和警告处理是两个重要的调试工具。Loguru作为一个流行的日志记录库，提供了强大的日志功能，但在与Python内置的warnings模块集成时，可能会遇到一些需要特别注意的问题。

问题背景

当开发者使用Loguru捕获Python警告信息时，默认情况下日志中显示的源位置（文件名和行号）实际上是调用showwarning函数的位置，而不是原始警告发出的位置。这会导致调试信息不准确，给问题排查带来困难。

解决方案

Loguru提供了.opt()方法的depth参数来解决这个问题。通过设置适当的depth值，可以让日志记录器回溯调用栈，找到警告实际发出的位置。

def showwarning(message, *args, **kwargs):
    logger.opt(depth=2).warning(message)
    showwarning_(message, *args, **kwargs)

这里的depth=2表示让Loguru跳过当前函数和警告处理函数的调用栈层级，直接记录原始警告发出的位置。

进阶问题与处理

在实际应用中，Python的warnings.warn()方法还支持stacklevel参数，用于进一步控制警告信息的源位置计算。然而，由于Python内部实现的原因，stacklevel参数并不会传递给showwarning函数。

对于这种情况，开发者有两种处理方式：

1. 手动计算调用栈深度：可以通过遍历调用栈来精确计算警告发出的位置，但这种方法实现较为复杂。

2. 直接使用警告参数：更实用的方法是利用showwarning函数接收到的filename和lineno参数，直接将这些信息包含在日志消息中：

def showwarning(message, category, filename, lineno, file=None, line=None):
    logger.opt(depth=2).warning("警告来自'{}:{}': {}", filename, lineno, message)
    showwarning_(message, category, filename, lineno, file, line)

最佳实践

为了获得最准确的警告源位置信息，建议开发者：

1. 始终使用.opt(depth=2)来处理警告信息
2. 对于需要精确控制警告位置的情况，考虑直接使用filename和lineno参数
3. 在团队项目中统一警告处理方式，确保日志信息的一致性

通过合理配置Loguru的警告捕获功能，开发者可以获得更加准确和有用的调试信息，提高问题排查的效率。