本技能说明 Warp 代码库运行期信息的两条通道。log::error!/warn!/info!/debug!/trace! 是本地诊断日志,写入终端或日志文件;在带崩溃上报的构建中,Error/Warn/Info 会上传为 Sentry breadcrumb,Debug/Trace 完全不上传。report_error! 则向 Sentry 捕获结构化事件(真正的问题)。因此 log::error! 不会创建 Sentry issue,只有 report_error! 和 panic 会。
选择依据是失败责任归属与用户影响,而非感觉严重程度:report_error! 用于可行动问题(违反不变量、进入不可能状态,或外部原因但影响严重需绕过);log::error! 用于非本代码过错的真实失败;log::warn! 用于非理想但基本可预期、可恢复或降级的情况;其他用合适的 log::* 级别。同一失败只上报一次,在停止传播的汇点处上报。
日志级别默认过滤为 Info,故 debug!/trace! 需 RUST_LOG 开启;热路径与逐条消息必须用 debug!/trace!。不要在任何级别记录密钥或凭据;可能敏感的信息用 safe_error!、safe_warn!、safe_info!、safe_debug! 等宏,它们分 safe: 与 full: 两个分支,发布渠道记录 safe:,开发构建记录 full:。
report_error! 运行时会检查 err.is_actionable():可行动则上报 Sentry 并以 Error 级别记录,不可行动则仅以 Warn 记录。由于事件无堆栈,Sentry 依据消息文本生成指纹,消息须为静态字符串,实例数据放在错误链(.context())或 extra: 中,避免割裂分组。优先使用类型化错误枚举并实现 ErrorExt、register_error!;仅在无 Result、无类型错误可用时才用 anyhow::anyhow!。不要在返回或传播错误处重复上报;若函数自身返回错误,可用 log::warn!/log::error! 留 breadcrumb,把 report_error! 留给汇点。缺失事实暂未提供。