RetryPlugin class

重试插件

基于 dio_smart_retry 的重试管理，支持全局和单次请求级别的重试过滤。 懒加载安装 SmartRetryInterceptor 到 Dio 实例。 priority = 80

基本用法

// 使用默认重试逻辑
RetryPlugin(retries: 3)

// 使用 SmartError 模式匹配自定义重试
RetryPlugin(
  retries: 3,
  shouldRetry: (error) => switch (error) {
    NetworkError() => true,
    TimeoutError() => true,
    ResponseError(:final statusCode) => statusCode >= 500,
    _ => false,
  },
)

// 使用默认 shouldRetry
RetryPlugin(shouldRetry: RetryPlugin.defaultShouldRetry)

全局配置

SmartDio.init(SmartConfig(
  globalPlugins: [
    RetryPlugin(
      retries: 3,
      shouldRetry: RetryPlugin.defaultShouldRetry,
    ),
  ],
));

单次请求覆盖

// 仅重试网络错误
SmartDio.get('/api',
  extraPlugins: [
    RetryPlugin(shouldRetry: (e) => e is NetworkError),
  ],
);

// 完全禁用重试
SmartDio.get('/no-retry', excludePlugins: {RetryPlugin});

优先级

1. retryEvaluator（直接使用 dio_smart_retry 原生接口）
2. shouldRetry（基于 SmartError，适配为 RetryEvaluator）
3. dio_smart_retry 默认逻辑（都不传时）