Dio 拦截器锁机制使用指南

理解Dio拦截器中的锁机制

Dio是一个强大的Dart/Flutter HTTP客户端库，它提供了灵活的拦截器系统。在Dio 5.x版本中，拦截器的锁机制发生了变化，这导致了一些开发者在使用过程中遇到问题。

问题背景

在Dio的早期版本中，拦截器提供了requestLock和responseLock属性，开发者可以直接通过dio.interceptors.requestLock来访问这些锁。然而，在5.x版本中，这个API发生了变化，直接访问这些属性会导致编译错误。

新版解决方案

Dio 5.x引入了QueuedInterceptor类来替代原有的锁机制访问方式。要正确使用拦截器锁，应该：

1. 使用QueuedInterceptor而不是InterceptorsWrapper
2. 通过lock()和unlock()方法直接控制锁状态

正确实现示例

@riverpod
Dio dio(DioRef ref) {
  final dio = Dio();
  dio.interceptors.add(QueuedInterceptor(
    onRequest: (RequestOptions requestOptions, 
        RequestInterceptorHandler handler) async {
      requestOptions.baseUrl = baseurl;
      var accessToken = await storage.read(key: 'accessToken');
      requestOptions.headers
          .putIfAbsent('Authorization', () => 'Bearer $accessToken');
      handler.next(requestOptions);
    },
    onError: (DioException err, ErrorInterceptorHandler handler) async {
      if (err.response?.statusCode == 401) {
        // 新版直接使用lock()方法
        lock();
        // 处理401错误的逻辑...
        unlock(); // 处理完成后记得解锁
      }
    }
  ));
  return dio;
}

锁机制的实际应用场景

拦截器锁在以下场景特别有用：

1. 令牌刷新：当检测到401未授权错误时，可以锁定请求，刷新令牌后再继续
2. 请求排队：确保某些请求按特定顺序执行
3. 并发控制：限制同时进行的请求数量

最佳实践建议

1. 总是确保在锁定后最终会解锁，避免死锁
2. 考虑使用try-finally块确保锁一定会被释放
3. 对于复杂的拦截逻辑，可以考虑将拦截器拆分为多个专门的拦截器

总结

Dio 5.x对拦截器API进行了改进，虽然改变了锁机制的访问方式，但提供了更简洁的API。理解并正确使用QueuedInterceptor可以帮助开发者构建更健壮的HTTP请求处理流程，特别是在处理认证令牌刷新等复杂场景时。