structlog 25.4.0版本发布：异常组支持与Python 3.13兼容性升级

structlog是一个强大的Python结构化日志记录库，它通过处理器链的方式提供了灵活且可扩展的日志记录功能。与标准库logging模块相比，structlog更注重于结构化数据的记录，使得日志信息更易于解析和分析。

主要更新内容

Python 3.13.4兼容性修复

本次发布的一个重要背景是即将到来的Python 3.13.4版本中包含了一个向后不兼容的变更。这个变更影响了logging.Logger.isEnabledFor()方法的行为：当有日志条目正在处理时，该方法现在会始终返回False。

这一变化主要影响了structlog标准库集成中的structlog.stdlib.filter_by_level()功能。开发者应当在升级Python 3.13.4之前先升级structlog到25.4.0版本，以确保日志过滤功能正常工作。

异常组支持

25.4.0版本引入了对Python异常组(Exception Groups)的支持，这一功能借鉴了Rich库的实现方式。异常组是Python 3.11引入的新特性，允许将多个异常作为一个组抛出和处理。

structlog的tracebacks模块现在能够正确处理异常组，新增了两个重要字段：

• is_group: 布尔值，标识是否为异常组
• exceptions: 包含所有子异常的列表

这一改进使得structlog能够更全面地捕获和记录复杂的异常情况，特别是在异步编程场景中，异常组的使用越来越普遍。

其他改进

异常美化处理器修复

ExceptionPrettyPrinter处理器现在能够正确尊重exception_formatter参数，而不是总是使用默认的格式化器。这意味着开发者可以更灵活地自定义异常信息的显示方式。

技术细节

对于异常组的支持实现，structlog采用了类似Rich库v14.0.0的处理方式。异常组中的每个子异常都会被递归处理，最终形成一个完整的异常跟踪树。这种处理方式特别适合复杂的并发编程场景，能够清晰地展示异常之间的关系。

在性能方面，structlog保持了其一贯的高效特性。即使增加了异常组的支持，日志处理的性能开销仍然保持在最低水平。

升级建议

对于正在使用structlog的项目，特别是那些计划升级到Python 3.13.4的项目，强烈建议尽快升级到25.4.0版本。升级过程通常是无缝的，但需要注意以下几点：

1. 如果项目中使用了自定义的异常处理器，可能需要检查它们是否能够正确处理异常组
2. 在Python 3.13.4环境下，确保所有依赖filter_by_level的功能都经过充分测试
3. 对于复杂的异步应用，可以利用新的异常组支持来获得更详细的错误信息

structlog 25.4.0继续保持了项目的稳定性和可靠性，同时增加了对Python最新特性的支持，为开发者提供了更强大的日志记录工具。