终极Dio请求合并策略：5个实用技巧实现请求去重与响应合并

【免费下载链接】dio A powerful HTTP client for Dart and Flutter, which supports global settings, Interceptors, FormData, aborting and canceling a request, files uploading and downloading, requests timeout, custom adapters, etc. 项目地址: https://gitcode.com/gh_mirrors/di/dio

Dio作为Dart和Flutter生态中强大的HTTP客户端，支持全局配置、拦截器、FormData、请求取消、文件上传下载等核心功能。在实际开发中，频繁发起重复请求不仅浪费网络资源，还可能导致数据不一致。本文将分享5个实用技巧，帮助开发者利用Dio的拦截器和CancelToken机制实现高效的请求合并与去重。

1. 利用CancelToken实现请求取消机制

Dio的CancelToken是处理请求取消的核心工具，通过它可以轻松实现重复请求的终止。在dio/lib/src/cancel_token.dart中定义的CancelToken类支持请求取消功能，当检测到重复请求时，可通过cancel()方法终止前一个未完成的请求。

// 创建取消令牌
final cancelToken = CancelToken();

// 发起请求时关联令牌
dio.get('/api/data', cancelToken: cancelToken);

// 需要取消时调用
cancelToken.cancel('请求已取消');

2. 自定义拦截器实现请求去重逻辑

Dio的拦截器机制（dio/lib/src/interceptor.dart）允许在请求发送前进行拦截处理。通过创建自定义拦截器，我们可以维护一个请求队列，记录当前正在进行的请求，对重复请求进行拦截或合并。

class DedupInterceptor extends Interceptor {
  final Map<String, CancelToken> _requestTokens = {};

  @override
  void onRequest(RequestOptions options, RequestInterceptorHandler handler) {
    final key = '${options.method}-${options.path}';
    if (_requestTokens.containsKey(key)) {
      // 取消重复请求
      _requestTokens[key]?.cancel('重复请求已取消');
    }
    final cancelToken = CancelToken();
    _requestTokens[key] = cancelToken;
    options.cancelToken = cancelToken;
    handler.next(options);
  }

  // 请求完成后移除令牌
  @override
  void onResponse(Response response, ResponseInterceptorHandler handler) {
    final key = '${response.requestOptions.method}-${response.requestOptions.path}';
    _requestTokens.remove(key);
    handler.next(response);
  }
}

// 添加拦截器
dio.interceptors.add(DedupInterceptor());

3. 基于请求参数的高级去重策略

简单的URL去重可能无法满足复杂场景，需要结合请求参数生成唯一键。例如，在dio/lib/src/parameter.dart中处理的请求参数，可以通过序列化参数生成唯一标识符，确保相同参数的请求被正确去重。

String generateRequestKey(RequestOptions options) {
  final params = options.queryParameters;
  final data = options.data;
  final paramStr = params.isNotEmpty ? jsonEncode(params) : '';
  final dataStr = data != null ? jsonEncode(data) : '';
  return '${options.method}-${options.path}-$paramStr-$dataStr';
}

4. 响应合并与结果缓存

对于相同请求，除了取消重复请求外，还可以缓存首次请求的结果并复用。通过拦截器结合缓存工具（如dio_cache_interceptor），可以实现响应结果的自动缓存与合并。

// 缓存拦截器示例（需引入第三方库）
dio.interceptors.add(DioCacheInterceptor(options: CacheOptions(
  store: MemCacheStore(),
  policy: CachePolicy.forceCache,
)));

5. 结合队列机制处理并发请求

当多个组件同时发起相同请求时，可以将请求加入队列，确保只有一个请求发送，其他请求等待结果返回后共享响应。这种机制特别适用于列表刷新、分页加载等场景。

Dio请求合并策略流程图，展示了请求拦截、去重、缓存的完整流程

总结

通过上述5个技巧，开发者可以充分利用Dio的拦截器和CancelToken特性，实现高效的请求合并与去重。核心实现包括：

• 利用CancelToken取消重复请求
• 自定义拦截器管理请求状态
• 基于URL和参数生成唯一请求键
• 结合缓存策略复用响应结果
• 使用队列机制处理并发请求

这些策略不仅能减少网络开销，还能提升应用性能和用户体验。更多高级用法可参考Dio官方文档和拦截器源码（dio/lib/src/interceptors/）。

【免费下载链接】dio A powerful HTTP client for Dart and Flutter, which supports global settings, Interceptors, FormData, aborting and canceling a request, files uploading and downloading, requests timeout, custom adapters, etc. 项目地址: https://gitcode.com/gh_mirrors/di/dio