Flutter/Dart 网络访问检测跨设备运行结果异常问题排查

安全阿岳

2026-8-27

问题产生的核心原因

你遇到的检测结果不一致问题，本质是对InternetAddress.lookup方法的作用存在认知偏差，叠加不同设备的网络环境差异导致的：

InternetAddress.lookup本身只做DNS域名解析，不会实际发起网络连接验证公网连通性。这个方法能不能成功，完全依赖当前设备配置的DNS服务器能不能正常返回目标域名的解析结果。
不同设备的默认DNS配置差异极大：Android Studio官方模拟器默认走谷歌公共DNS，在可顺畅访问海外网络的环境下解析example.com成功率极高；但国产安卓真机、部分第三方模拟器默认使用运营商本地DNS，很多运营商的公共DNS对example.com这类海外站点的解析不稳定，甚至会直接拦截解析请求，哪怕设备实际能正常访问国内网站，解析这个域名也会失败抛出SocketException。
Release打包和Debug运行的环境差异：Debug模式下Flutter会自动给应用临时授予网络权限，部分模拟器还会做网络请求代理；但Release打包后如果没有手动在AndroidManifest.xml里声明网络权限，也会直接导致所有网络请求失败，刚好触发你代码里的无网络分支。

原有代码存在的错误

判定逻辑完全不可靠：把「DNS解析成功」和「能正常访问互联网」划等号是完全错误的。比如设备连了需要网页认证的公共WiFi时，DNS解析往往是通的，但实际根本上不了网；反过来DNS解析临时失败的时候，设备也可能已经正常联网，只是当前DNS服务器没响应而已。
没有做结果有效性校验：哪怕DNS返回了结果，你也没有校验返回的IP是不是有效公网地址，遇到DNS劫持返回假内网IP的场景，会直接误判为有网。
缺少超时控制：InternetAddress.lookup默认没有超时时间，网络波动时方法会一直挂起，既不会走成功分支也不会走失败分支。
存在重复弹窗风险：每次检测失败就直接弹对话框，用户多次点击检测按钮时会弹出多层弹窗，交互逻辑有问题。
生命周期调用错误：在initState里直接调用带弹窗的逻辑，会在组件还没完成第一帧渲染时就操作上下文，部分场景下会触发运行时异常。

可落地的修复方案

先确认配置：在项目的android/app/src/main/AndroidManifest.xml文件中，<application>标签外部加上网络权限声明：

<uses-permission android:name="android.permission.INTERNET" />

替换核心检测逻辑，不要只做DNS解析，增加TCP连通性校验，替换测试域名为国内可稳定访问的公共服务域名，加上超时控制：

// 新增弹窗状态标记，避免重复弹窗
bool isDialogShowing = false;

Future<bool> checkUserConnection() async {
  try {
    // 选用国内稳定公共域名做解析，避免跨境解析失败
    final lookupResult = await InternetAddress.lookup('baidu.com')
        .timeout(const Duration(seconds: 3));
    if (lookupResult.isNotEmpty && lookupResult[0].rawAddress.isNotEmpty) {
      // 发起实际TCP连接验证连通性，验证完成立刻销毁连接
      final socket = await Socket.connect(
        lookupResult[0],
        443,
        timeout: const Duration(seconds: 3),
      );
      socket.destroy();
      setState(() {
        ActiveConnection = true;
        T = "网络连接正常";
      });
      return true;
    }
  } on SocketException catch (_) {
    setState(() {
      ActiveConnection = false;
      T = "请连接网络后重试";
    });
    // 仅当没有弹窗在显示时才弹出提示
    if (!isDialogShowing && mounted) {
      isDialogShowing = true;
      showInternetDialog(context).then((_) => isDialogShowing = false);
    }
    return false;
  } on TimeoutException catch (_) {
    // 单独处理超时场景，逻辑和无网一致
    setState(() {
      ActiveConnection = false;
      T = "网络连接超时，请检查后重试";
    });
    return false;
  }
  return false;
}

// 修正initState的调用时机，等组件挂载完成再执行检测
@override
void initState() {
  super.initState();
  WidgetsBinding.instance.addPostFrameCallback((_) {
    checkUserConnection();
  });
}

内容的提问来源于stack exchange，提问作者Texter