Flutter客户端无法发现局域网内服务器问题排查求助

核心问题分析 #

你的代码存在三个关键问题，导致客户端无法探测到服务器：

1. 服务器绑定127.0.0.1（本地回环地址），仅本机可访问，局域网内其他设备无法连接
2. 客户端探测的网段错误（127.0.0是回环网段，不是局域网网段）
3. 绑定指定IP时报错是因为你用的IP并非服务器设备当前活跃的局域网IP

修复步骤 #

1. 修正服务器绑定地址

不要绑定127.0.0.1或固定IP，改为绑定0.0.0.0，这样服务器会监听设备上所有可用的网络接口（包括局域网IP）：

Future<void> start() async {
    runZoned(() async {
        // 绑定0.0.0.0监听所有接口
        server = await ServerSocket.bind('0.0.0.0', 4000);
        running = true;
        server!.listen(onRequest);
        const message = "Server is listening on port 4000";
        onData!(Uint8List.fromList(message.codeUnits));
    }, onError: onError);
}

如果需要获取服务器实际的局域网IP用于调试，可以添加代码获取本机活跃IP：

// 获取本机局域网IP
Future<String> getLocalIp() async {
  for (var interface in await NetworkInterface.list()) {
    for (var addr in interface.addresses) {
      // 筛选IPv4且不是回环地址
      if (addr.type == InternetAddressType.IPv4 && !addr.isLoopback) {
        return addr.address;
      }
    }
  }
  return '127.0.0.1';
}

2. 修正客户端探测网段

客户端需要探测服务器所在的局域网网段，比如服务器设备的IP是192.168.1.104，就用192.168.1作为网段前缀：

getIpAddress() {
    // 替换为你的局域网网段前缀，比如192.168.1或10.0.0
    stream = NetworkAnalyzer.discover2('192.168.1', 4000);
    stream!.listen((NetworkAddress networkAddress) {
        if(networkAddress.exists) {
            address = networkAddress;
            clientModel = ClientModel(
                hostname: networkAddress.ip, 
                onData: onData, 
                onError: onError, 
                port: 4000);
            // 找到设备后可以取消监听，避免重复探测
            stream!.cancel();
        }
    });

    update();
}

注意：如果客户端是安卓模拟器，需要用10.0.2.2访问电脑本地服务器，或者确保模拟器和服务器在同一局域网网段。

3. 解决网络权限问题

确保安卓Manifest文件中添加了必要的网络权限：

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

如果是Android 10及以上，还需要添加：

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

4. 确保设备在同一局域网

服务器和客户端必须连接同一个WiFi网络，避免跨网段无法访问。

额外调试建议 #

• 用手机浏览器直接访问服务器IP+端口（比如http://192.168.1.104:4000），验证服务器是否可访问
• 在服务器的onRequest方法中添加日志，确认是否有客户端连接请求
• 客户端探测时可以打印所有networkAddress信息，排查是否有设备被遗漏

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