问题现象与背景
当开发者尝试使用loguru.add_level_xml()方法时，通常会遇到以下报错：
AttributeError: module 'loguru' has no attribute 'add_level_xml'
这个错误表明用户可能混淆了loguru库的API用法。loguru（v0.6.0+）实际上并没有提供add_level_xml方法，这是许多开发者在使用第三方教程或旧版本文档时容易产生的误解。
错误原因深度分析
- API变更历史：loguru在0.5.0版本后重构了日志级别API
- 命名混淆：用户可能将
add_level与XML配置功能联想 - 文档误导：某些第三方教程未及时更新API说明
- 版本兼容性：旧版实验性功能在新版被移除
5种解决方案
1. 使用正确的add_level方法
from loguru import logger
def custom_level():
logger.level("CUSTOM", no=15, color="")
logger.log("CUSTOM", "自定义消息")
2. 通过字典配置实现XML类似功能
config = {
"levels": [{"name": "XML", "no": 25, "color": ""}],
"handlers": [...]
}
logger.configure(**config)
3. 检查loguru版本
pip show loguru # 确认版本≥0.6.0 pip install -U loguru
4. 自定义日志过滤器
def xml_filter(record):
return "xml" in record["extra"]
logger.add(xml_processor, filter=xml_filter)
5. 实现XML格式输出
class XMLFormatter:
def format(self, record):
return f"<log level='{record['level']}'>{record['message']}</log>"
logger.add(sys.stdout, format=XMLFormatter().format)
最佳实践建议
- 始终参考官方文档
- 使用
logger.level()而非不存在的方法 - 考虑使用
logger.bind()实现上下文日志 - 对于复杂需求，组合使用过滤器和格式化器
扩展应用场景
| 场景 | 推荐方案 |
|---|---|
| 需要结构化日志 | 结合JSON格式化器 |
| 多级别日志处理 | 使用logger.configure批量设置 |
| 企业级日志系统 | 集成ELK等专业工具 |