Loguru日志库中处理包含大括号的日志消息

在使用Python的Loguru日志库时，开发者可能会遇到一个常见问题：当日志消息中包含大括号{}时，会导致格式化错误。这种情况通常发生在记录JSON字符串或其他包含大括号结构的消息时。

问题现象

当开发者尝试记录类似'data: {"code":30004,"msg":"User not logged in"}'这样的消息时，Loguru会抛出KeyError异常。这是因为Loguru内部使用了format_map()方法来处理日志格式，而消息中的大括号被错误地解释为格式化占位符。

根本原因

问题的根源在于开发者错误地在自定义格式化函数中调用了.format()方法。在Loguru中，自定义格式化函数应该返回一个包含格式化标记的字符串，而不是直接进行格式化操作。Loguru会自动处理后续的格式化过程。

正确解决方案

正确的做法是简化自定义格式化函数，让它只返回格式字符串模板，而不进行实际的格式化操作。例如：

def formatter(record: "Record") -> str:
    return "<green>{time:YYYY-MM-DD HH:mm:ss,SSS}</green> - <level>{level:<5}</level> - <level>{message}</level>\n"

深入理解

Loguru的设计哲学是将格式化过程分为两个阶段：

1. 开发者定义格式模板
2. Loguru在记录日志时自动应用模板

这种设计使得格式化更加灵活，同时避免了开发者手动处理格式化带来的各种问题。当日志消息中包含大括号时，只要不将它们作为格式化占位符使用，Loguru就能正确处理这些特殊字符。

最佳实践

1. 避免在自定义格式化函数中调用.format()或.format_map()
2. 对于包含大括号的消息，确保它们不作为格式化占位符
3. 使用Loguru提供的标准格式化语法来定义输出格式
4. 对于复杂的日志结构，考虑使用Loguru的序列化功能或自定义过滤器

通过遵循这些原则，开发者可以充分利用Loguru的强大功能，同时避免常见的格式化陷阱。