NoneBot2 日志系统详解：从基础使用到高级定制-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00065/article/details/148465454

NoneBot2 日志系统详解：从基础使用到高级定制

nonebot2 跨平台 Python 异步聊天机器人框架 / Asynchronous multi-platform chatbot framework written in Python 项目地址: https://gitcode.com/gh_mirrors/no/nonebot2

前言

在机器人开发过程中，日志系统是开发者最重要的调试工具之一。NoneBot2 基于强大的 Loguru 库构建了一套完善的日志系统，本文将全面介绍如何在 NoneBot2 项目中高效地使用日志功能。

基础日志记录

NoneBot2 提供了开箱即用的日志功能，开发者可以直接导入并使用预配置的 logger 对象：

from nonebot import logger

# 不同级别的日志记录
logger.trace("详细的跟踪信息")  # 最详细的日志级别
logger.debug("调试信息")       # 调试时使用
logger.info("常规运行信息")    # 记录正常运行状态
logger.success("成功信息")     # 记录成功操作
logger.warning("警告信息")     # 潜在问题提示
logger.error("错误信息")       # 错误情况记录
logger.critical("严重错误")    # 系统级严重错误

日志级别说明

NoneBot2 默认日志级别为 INFO，这意味着只有 INFO 及以上级别的日志会被输出。这个设计避免了开发环境中过多无关日志的干扰。

高级日志技巧

异常记录

在捕获异常时，可以使用 exception 选项自动记录完整的堆栈信息：

try:
    risky_operation()
except Exception:
    logger.opt(exception=True).error("操作失败")

彩色输出

Loguru 支持在控制台输出彩色日志，增强可读性：

logger.opt(colors=True).info(
    "状态: <green>正常</green>, 温度: <yellow>警告</yellow>"
)

自定义日志系统

修改默认配置

NoneBot2 允许开发者完全自定义日志格式和行为：

from nonebot.log import logger_id, default_filter

# 移除默认处理器
logger.remove(logger_id)

# 添加自定义处理器
logger.add(
    sys.stdout,
    level="DEBUG",  # 设置日志级别
    format="<green>{time:YYYY-MM-DD HH:mm:ss}</green> | "
           "<level>{level: <8}</level> | "
           "<cyan>{name}</cyan>:<cyan>{function}</cyan> - "
           "<level>{message}</level>",
    filter=default_filter  # 使用默认过滤器
)

文件日志

将日志写入文件是生产环境的常见需求：

# 按级别分离日志文件
logger.add("debug.log", level="DEBUG", rotation="1 day")
logger.add("error.log", level="ERROR", rotation="1 week")

与标准库集成

NoneBot2 提供了与 Python 标准库 logging 模块的集成方案：

import logging
from nonebot.log import LoguruHandler

# 配置根日志记录器
logging.basicConfig(handlers=[LoguruHandler()], level=logging.INFO)

# 或者为特定模块配置
module_logger = logging.getLogger("some.module")
module_logger.addHandler(LoguruHandler())