手机连接ESP32热点时Dart Socket.connect连接失败问题

可能的连接失败原因 #

• Android系统网络策略限制：Pixel系列设备在连接无互联网的热点时，可能触发系统的"无网络优化"机制，限制本地Socket连接。可尝试在热点设置中关闭"无互联网时保持连接"选项，或手动标记该热点为"已计量网络"。
• IP/端口与连通性问题：确认ESP32分配给Pixel 4a的IP在本地网段内，同时验证端口是否开放。可通过adb shell ping [ESP32_IP]测试连通性，用adb shell telnet [ESP32_IP] [port]检查端口是否可访问。
• 未设置Socket超时：Dart的Socket.connect默认无超时配置，导致无限等待。添加超时参数可触发明确的错误反馈，而非挂起。
• 权限配置缺失：检查AndroidManifest.xml是否添加了必要权限：

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

Dart/Flutter层面的调试API #

1. 带超时的Socket.connect #

通过添加超时参数，强制触发错误抛出，替代无限等待：

try {
  var socket = await Socket.connect(ip, port, timeout: Duration(seconds: 5));
} on SocketException catch (e) {
  print('错误码：${e.osError?.errorCode}');
  print('错误详情：${e.message}');
}

2. 使用RawSocket获取底层状态 #

RawSocket提供更细粒度的连接状态反馈：

try {
  var rawSocket = await RawSocket.connect(ip, port);
  print('当前连接状态：${rawSocket.status}');
  rawSocket.close();
} catch (e) {
  print('连接错误：$e');
}

3. 捕获系统级错误信息 #

在SocketException中获取系统原生错误码与描述：

try {
  var socket = await Socket.connect(ip, port, timeout: Duration(seconds: 5));
} on SocketException catch (e) {
  if (e.osError != null) {
    print('系统错误码：${e.osError.errorCode}');
    print('系统错误信息：${e.osError.message}');
  }
}

是否需要调用原生API？ #

若Dart层面无法获取足够信息，可通过MethodChannel调用Android原生Java API，直接获取系统底层网络错误：

Java端示例代码 #

public static String testSocketConnection(String ip, int port) {
    try {
        Socket socket = new Socket();
        socket.connect(new InetSocketAddress(ip, port), 5000);
        socket.close();
        return "连接成功";
    } catch (IOException e) {
        String errorCode = "";
        if (e instanceof SocketException) {
            errorCode = "错误码：" + ((SocketException) e).getErrorCode();
        }
        return "连接失败：" + e.getMessage() + " " + errorCode;
    }
}

Flutter端调用 #

通过MethodChannel与原生代码通信，获取更直接的系统错误信息，比如ECONNREFUSED（连接被拒绝）、ETIMEDOUT（超时）等。

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