Python loguru库的add_level方法常见问题：如何解决日志级别重复定义的报错

问题现象与报错分析

当开发者尝试使用loguru.add_level()方法添加自定义日志级别时，常会遇到类似"ValueError: Level 'MYLEVEL' already exists"的报错。这种情况通常发生在：

重复调用add_level方法注册同级别名称
自定义级别与系统内置级别(DEBUG/INFO等)冲突
多线程环境下并发注册级别
动态导入导致模块重复执行

根本原因剖析

loguru内部使用单例模式管理日志级别，通过_levels字典维护所有可用级别。当检测到级别名称、数值或颜色配置冲突时，会触发保护机制抛出异常。底层实现涉及：

# loguru/_logger.py 源码片段
if name in self._levels:
    raise ValueError(f"Level '{name}' already exists")

5种解决方案详解

1. 条件注册模式

from loguru import logger

if not logger.level("MYLEVEL").no == 25:
    logger.add_level("MYLEVEL", 25, color="")

2. 单例装饰器封装

from functools import wraps

def singleton_level(func):
    _registry = set()
    @wraps(func)
    def wrapper(name, *args, **kwargs):
        if name not in _registry:
            _registry.add(name)
            return func(name, *args, **kwargs)
    return wrapper

logger.add_level = singleton_level(logger.add_level)

3. 级别存在性检查

def safe_add_level(name, no, color=""):
    try:
        logger.add_level(name, no, color)
    except ValueError as e:
        if "already exists" not in str(e):
            raise

4. 使用环境变量控制

import os

if os.environ.get("MYLEVEL_REGISTERED") != "1":
    logger.add_level("MYLEVEL", 25)
    os.environ["MYLEVEL_REGISTERED"] = "1"

5. 模块级缓存方案

_registered_levels = {}

def register_custom_level(level_name):
    if level_name not in _registered_levels:
        logger.add_level(level_name, _registered_levels[level_name])
        _registered_levels[level_name] = True

性能优化建议

方案	内存开销	执行速度	线程安全
条件注册	低	快	是
装饰器	中	中	否

最佳实践总结

在应用程序启动时集中注册所有自定义级别
使用枚举类管理级别常量
单元测试中添加级别冲突测试用例
考虑使用logging.addLevelName兼容方案
文档中明确记录已使用的级别数值范围