Flutter网络请求重试插件dio_retry_fixed的使用

dio_retry_fixed 是一个用于 dio 的插件，用于在请求失败时自动重试。

使用方法

基本配置

首先，你需要安装并导入 dio 和 dio_retry_fixed 包。然后，你可以添加 RetryInterceptor 到你的 Dio 实例中。

import 'package:dio/dio.dart';
import 'package:dio_retry_fixed/dio_retry_fixed.dart';

void main() async {
  final dio = Dio();
  
  // 添加重试拦截器
  dio.interceptors.add(RetryInterceptor(dio: dio));
}

全局重试选项

你可以在创建 Dio 实例时设置全局重试选项，例如重试次数、重试间隔和错误评估逻辑。

import 'package:dio/dio.dart';
import 'package:dio_retry_fixed/dio_retry_fixed.dart';

void main() async {
  final dio = Dio();
  
  // 添加重试拦截器，并设置全局重试选项
  dio.interceptors.add(RetryInterceptor(
    dio: dio,
    options: const RetryOptions(
      retries: 3, // 重试次数
      retryInterval: const Duration(seconds: 1), // 重试间隔
      retryEvaluator: (error) => error.type != DioErrorType.CANCEL && error.type != DioErrorType.RESPONSE, // 错误评估逻辑
    ),
  ));
}

发送带有重试选项的请求

你也可以为单个请求指定重试选项。

import 'package:dio/dio.dart';
import 'package:dio_retry_fixed/dio_retry_fixed.dart';

void main() async {
  final dio = Dio();
  
  // 添加重试拦截器
  dio.interceptors.add(RetryInterceptor(dio: dio));

  // 发送带有自定义重试选项的请求
  try {
    final response = await dio.get(
      "http://www.flutter.dev",
      options: Options(
        extra: RetryOptions(
          retryInterval: const Duration(seconds: 10),
        ).toExtra(),
      ),
    );
    print(response.data);
  } catch (e) {
    print("请求失败: $e");
  }
}

发送不带重试选项的请求

如果你希望某个请求不进行重试，可以设置 noRetry 选项。

import 'package:dio/dio.dart';
import 'package:dio_retry_fixed/dio_retry_fixed.dart';

void main() async {
  final dio = Dio();
  
  // 添加重试拦截器
  dio.interceptors.add(RetryInterceptor(dio: dio));

  // 发送不带重试选项的请求
  try {
    final response = await dio.get(
      "http://www.flutter.dev",
      options: Options(
        extra: RetryOptions.noRetry().toExtra(),
      ),
    );
    print(response.data);
  } catch (e) {
    print("请求失败: $e");
  }
}

记录重试操作

你可以通过设置 logger 来记录重试操作。

import 'package:dio/dio.dart';
import 'package:dio_retry_fixed/dio_retry_fixed.dart';
import 'package:logging/logging.dart';

void main() async {
  // 显示日志
  Logger.root.level = Level.ALL;
  Logger.root.onRecord.listen((record) {
    print('${record.level.name}: ${record.time}: ${record.message}');
  });

  final dio = Dio();
  
  // 添加重试拦截器，并设置日志记录器
  dio.interceptors.add(RetryInterceptor(
    dio: dio,
    logger: Logger("Retry"),
  ));

  // 发送请求
  try {
    await dio.get("http://www.flutter.dev");
  } catch (e) {
    print("请求失败: $e");
  }
}