SuperAPI AI 工具集

tauri-errors-ipc

编程与开发

查看项目

更新于 10-16 06:18

技能介绍

用途:这是一个 Tauri 2 的 IPC 错误诊断技能,适用于遇到 invoke 报错、序列化失败或 IPC 相关 panic 时,按决策树定位问题。

主要能力:覆盖六类问题。命令未找到时,检查 generate_handler![] 注册、仅保留一个 invoke_handler、#[tauri::command] 属性、snake_case 命令名与模块内 pub 可见性。序列化与类型不匹配时,检查参数命名(Rust snake_case 对应 JS camelCase)、类型兼容(如 Option 用 null 而非 undefined)、结构体 derive Deserialize/Serialize 及 rename_all。错误序列化时,要求错误类型实现 Display 与 Serialize,推荐 thiserror 加手写 Serialize,避免 Result<T, String>。异步 panic 时,避免 unwrap/expect,改用 ?,异步命令用 owned 类型,阻塞工作放入 tokio::task::spawn_blocking。结构化错误时,用带 tag 的 serde 枚举让前端按 kind 分支处理。死锁与阻塞时,同步命令勿做 I/O,避免嵌套 Mutex,跨 await 使用 tokio::sync::Mutex。

使用方式:按症状进入对应章节逐步排查;前端始终用 try/catch 包裹 invoke,可封装 safeInvoke 返回 data/error。

适用场景:Tauri 2 应用开发中调试前后端通信。

限制:资料未提供安装命令、收费与平台信息;部分细节需参考其 references 与官方文档。