SuperAPI AI 工具集

tauri-errors-runtime

通用与其它

查看项目

更新于 10-15 22:18

技能介绍

用途:在 Tauri 2 应用出现运行时 panic、状态错误或意外崩溃时,按错误类别快速定位问题。资料将运行时错误分为状态 panic、IPC 错误、窗口错误、插件错误、事件错误、资源错误与 panic/崩溃七类,并强调始终查看终端/控制台输出,因为 Tauri 会把 panic 和错误打印到 stderr。

主要能力:提供错误码对照表。状态类包括 ERR-R001 状态类型不匹配(State<'_, T> 的泛型必须与 manage() 传入类型完全一致)、ERR-R002 未注册状态、ERR-R003 嵌套 Mutex 死锁、ERR-R004 多余 Arc 包装。IPC 类包括 ERR-R010 命令未找到(检查 generate_handler!、权限、名称)、ERR-R011 参数类型不匹配(前端键名须 camelCase)、ERR-R012 未捕获 invoke 拒绝。窗口类包括 ERR-R020 窗口未找到、ERR-R021 销毁后操作。插件类包括 ERR-R030 插件未初始化、ERR-R031 插件权限未配置。事件类包括 ERR-R040 事件名非法(仅允许字母数字与 - / : _)、ERR-R041 监听器泄漏、ERR-R042 忘记 await listen。资源类包括 ERR-R050 asset 协议未启用、ERR-R051 CSP 拦截。崩溃类包括 ERR-R060 未处理 panic、ERR-R061 主线程阻塞。

使用方式:按诊断决策树判断是 panic、UI 冻结、命令失败、资源不加载还是内存增长,再查对应错误码。预防清单要求:命令处理器不用 unwrap() 而用 ? 与 Result;异步命令参数用 String 而非 &str;State 类型与 manage() 精确匹配;get_webview_window() 用 if let Some 保护;事件名只用 [a-zA-Z0-9-/:_];组件卸载时清理监听器;I/O、网络或重计算用 async 命令;前端 invoke() 包 try/catch。

适用场景与限制:适用于 Tauri 2 桌面应用的运行时调试与错误预防。资料未提供安装命令、版本要求、收费信息或平台支持范围,相关细节暂未提供。