メニュー
使用 fx_exception 构建统一异常追踪体系。提供 Code、Trace、TraceMixin 三个核心协议，各模块基于此扩展自定义异常。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | fx-exception-usage |
| description | 使用 fx_exception 构建统一异常追踪体系。提供 Code、Trace、TraceMixin 三个核心协议，各模块基于此扩展自定义异常。 |
| metadata | {"author":"toly","version":"0.0.1+1","tags":["fx","exception","trace","error","flutter"]} |
fx_exception: 0.0.1+2
检查项目是否包含 fx_exception 依赖。
| 协议 | 职责 |
|---|---|
Code mixin | 错误码标准，任何 enum with Code 即可接入 |
Trace mixin | 异常信息标准：code + message + error + stack |
TraceMixin | 异常分发，支持多监听器，addTraceListener / removeTraceListener / dispose |
1. 定义错误码 → enum XxxCode with Code { ... }
2. 定义异常类 → class XxxException with Trace implements Exception { ... }
3. 混入 TraceMixin → 需要分发异常的类 with TraceMixin
4. 监听 → addTraceListener 注册回调
#[[file:references/custom_code.md]]
#[[file:references/custom_trace.md]]
#[[file:references/trace_mixin.md]]
| 成员 | 说明 |
|---|---|
RequestErrorCode | 框架级错误码：convert(0)、emptyData(1)、exception(2) |
RequestException | 框架级请求异常，fx_dio 内部使用 |
kDefaultErrorHandler | 默认 debug 日志输出（debugPrint） |
ExceptionCallback | void Function(Trace trace) 类型别名 |
isTokenExpired）trace.error 的 runtimeType 做分流使用 fx_boot_starter 接入 App 启动流程。适用于需要闪屏页、初始化异步任务、启动状态管理的场景。
使用 fx_dio 进行 Flutter HTTP 请求开发。基于实际项目实践的模式，包含 Host 定义、请求发起、返回值处理、异常追踪等核心流程。
使用 fx_event 进行类型化事件通信。适用于回调层级过深、跨模块通信、远距离组件交互、异步请求-响应等场景。
使用 fx_trace 进行应用级异常/日志追踪。统一收集网络异常、业务提示、调试日志，支持级别过滤和 State 生命周期绑定。