如何在断网时终止Dio的Get请求并抛出错误？

问题本质 #

你设置的sendTimeout和receiveTimeout仅作用于已建立TCP连接后的传输阶段，断网时连连接都建立不了，这两个参数不会触发超时。真正管控连接建立阶段的是connectTimeout。

具体解决步骤 #

1. 配置连接超时参数 #

给Dio的BaseOptions加上connectTimeout，断网时连接建立失败会在指定时间后抛出错误：

Dio dio = Dio(BaseOptions(
  baseUrl: "你的基础接口地址",
  connectTimeout: const Duration(seconds: 10), // 连接超时10秒
  receiveTimeout: const Duration(seconds: 10),
  sendTimeout: const Duration(seconds: 10),
));

2. 提前检查网络状态 #

用connectivity_plus包在发起请求前直接判断是否联网，避免无效请求：

• 先在pubspec.yaml添加依赖：

dependencies:
  connectivity_plus: ^5.0.1 # 版本以最新官方为准

• 请求前检查网络：

import 'package:connectivity_plus/connectivity_plus.dart';

// 发起请求前执行
var networkStatus = await Connectivity().checkConnectivity();
if (networkStatus == ConnectivityResult.none) {
  // 直接触发错误提示
  throw Exception("无网络连接，请检查网络设置");
}

// 正常发起Get请求
final response = await dio.get("目标接口地址");

3. 全局拦截器统一处理 #

写一个Dio拦截器，自动处理所有请求的网络检查和错误捕获，不用每个请求都写重复代码：

class NetworkInterceptor extends Interceptor {
  @override
  void onRequest(RequestOptions options, RequestInterceptorHandler handler) async {
    var networkStatus = await Connectivity().checkConnectivity();
    if (networkStatus == ConnectivityResult.none) {
      return handler.reject(DioException(
        requestOptions: options,
        error: "无网络连接",
        type: DioExceptionType.connectionError,
      ));
    }
    super.onRequest(options, handler);
  }

  @override
  void onError(DioException err, ErrorInterceptorHandler handler) {
    // 捕获连接超时、无网等网络类错误
    if ([DioExceptionType.connectionTimeout, DioExceptionType.connectionError].contains(err.type)) {
      // 这里替换成你的错误提示逻辑，比如弹窗、Toast
      print("网络异常，请检查网络连接");
    }
    super.onError(err, handler);
  }
}

// 给Dio注册拦截器
dio.interceptors.add(NetworkInterceptor());

关键提醒 #

• 单独靠connectTimeout也能触发错误，但提前检查网络可以减少不必要的等待，提升用户体验
• 部分设备的网络状态判断可能有延迟，两者结合使用更稳妥

内容的提问来源于stack exchange，提问作者mohamed abderraouf douadi