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

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

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

前言

在机器人开发过程中，日志系统是开发者最得力的助手之一。NoneBot2 基于 Loguru 库构建了一套强大而灵活的日志系统，本文将全面介绍如何在 NoneBot2 项目中高效使用日志功能。

日志基础使用

日志级别介绍

NoneBot2 提供了7种标准日志级别，按严重程度从低到高排列：

TRACE - 最详细的跟踪信息
DEBUG - 调试信息
INFO - 常规运行信息
SUCCESS - 成功操作
WARNING - 潜在问题
ERROR - 错误情况
CRITICAL - 严重错误

基本日志记录

在 NoneBot2 中记录日志非常简单：

from nonebot import logger

logger.debug("调试信息")
logger.info("常规信息")
logger.warning("警告信息")
logger.error("错误信息")

默认情况下，NoneBot2 只会记录 INFO 及以上级别的日志，可以通过配置调整。

日志高级特性

异常记录

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

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

彩色输出

Loguru 支持在控制台输出彩色日志：

logger.opt(colors=True).info("<green>成功</green>连接到数据库")

结构化日志

对于复杂数据，可以使用 opt(record=True) 记录结构化信息：

data = {"user": "Alice", "action": "login"}
logger.opt(record=True).info("用户操作: {record[user]} 执行了 {record[action]}")

日志配置与自定义

默认日志格式

NoneBot2 的默认日志格式如下：

08-15 14:30:00 [INFO] plugin.weather | 成功获取天气数据

各部分的含义：

时间 (灰色)
日志级别 (彩色)
日志来源 (青色下划线)
日志消息

自定义日志处理器

如果需要完全自定义日志输出，可以移除默认处理器并添加自己的：

from nonebot.log import logger_id

# 移除默认处理器
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>:<cyan>{line}</cyan> - <level>{message}</level>"
)

文件日志记录

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

# 按文件大小轮转，每个文件最大10MB，保留3个备份
logger.add("runtime.log", rotation="10 MB", retention=3)

# 按时间轮转，每天午夜创建一个新文件
logger.add("runtime.log", rotation="00:00")

# 错误日志单独记录
logger.add("error.log", level="ERROR")

与标准库 logging 集成

NoneBot2 提供了将 Python 标准库 logging 重定向到 Loguru 的功能：

import logging
from nonebot.log import LoguruHandler

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

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