日志与错误处理

为 Bot 配置日志器后，可以指定日志写到哪里、采用什么格式、记录哪些级别。日志文件由应用创建和关闭。

需求	阅读
将日志写入文件或同时写入控制台	写入日志文件
结构化 JSON、动态日志级别	写入日志文件：格式与级别
观察处理函数错误及 panic	错误处理
检查平台错误码及 TraceID	错误处理：平台错误

需要在事件处理失败时更新指标或发送告警，可通过 WithErrorHandler 注册回调。是否输出日志不影响该回调。

注意事项

• SDK 默认不输出日志，不创建日志文件，也不修改 slog.Default()。
• WithLogger 只影响当前 Bot。其他机器人实例和独立的 api.Client 不受影响。
• 启用 SDK 日志后，故障日志默认只记录元数据。字段包括事件类型、处理阶段、是否 panic、API 状态、错误码和 TraceID。
• 业务文本、原始载荷、panic 值和堆栈可能含有敏感信息。应用自行判断是否记录。

另请参阅

快速开始 · 运行与关闭 · 官方 API 错误及全链路追踪