
本文讲解如何安全地从 json 配置文件中读取日志级别(如 `"logging.info"`),并将其解析为 python `logging` 模块对应的整数常量,避免因传入字符串导致 `valueerror: unknown level` 错误。
在实际项目中,将日志级别(如 INFO、DEBUG)外置到 JSON 配置文件中是一种常见做法,便于运维灵活调整而无需修改代码。但若直接将 "logging.INFO" 作为字符串写入 JSON 并原样传给 logger.setLevel(),Python 会将其视为普通字符串而非 logging.INFO 常量(其值为 20),从而触发 ValueError: Unknown level: 'logging.INFO'。
最推荐、安全且可维护的解决方案是:建立一个显式的字符串到日志级别常量的映射字典,而非使用 eval() 或 getattr() 动态解析模块属性(后者存在安全隐患和可读性问题)。
import logging
# 定义合法日志级别映射(键为配置中使用的字符串,值为 logging 模块对应常量)
LOG_LEVEL_MAP = {
"DEBUG": logging.DEBUG,
"INFO": logging.INFO,
"WARNING": logging.WARNING,
"WARN": logging.WARNING, # 兼容常见别名
"ERROR": logging.ERROR,
"CRITICAL": logging.CRITICAL,
"FATAL": logging.CRITICAL,
}
# 加载配置
with open("export_tool_config.json", "r") as f:
config = json.load(f)
# 读取配置中的 loglevel 字段(建议使用更简洁的字符串,如 "INFO")
raw_level = config.get("loglevel", "INFO").strip().upper()
# 安全查表转换
if raw_level not in LOG_LEVEL_MAP:
raise ValueError(f"Unsupported log level '{raw_level}' in config. "
f"Supported: {list(LOG_LEVEL_MAP.keys())}")
log_level = LOG_LEVEL_MAP[raw_level]
# 应用日志级别
logger = logging.getLogger(__name__)
logger.setLevel(log_level)✅ 优势说明:
- 安全:完全规避 eval() 或反射调用带来的任意代码执行风险;
- 清晰:映射关系一目了然,便于审查与扩展;
- 健壮:包含缺失键校验与友好的错误提示;
- 兼容性强:支持常见别名(如 "WARN" → WARNING),降低配置出错概率。
⚠️ 注意事项:
- 不要将 JSON 中的值设为 "logging.INFO" 这类带模块路径的字符串——这会增加映射复杂度且无实际收益;
- logging 模块原生支持 setLevel("INFO")(传入纯字符串),因此 JSON 中直接写 "INFO" 即可,无需冗余前缀;
- 若必须保留 "logging.INFO" 格式(如历史兼容),可扩展映射字典:"logging.INFO": logging.INFO,但不推荐。
总结:通过预定义的、受控的字符串→常量映射表,既能实现配置驱动的日志级别管理,又能保障代码安全性与可维护性。这是生产环境中推荐的标准实践。









