Avalonia安卓端TCP Socket连接工业硬件超时，桌面端正常

开发跨平台C#应用（Avalonia/Xamarin）时遇到TCP Socket连接超时问题，表现如下：

• 服务器为工业硬件设备，自身作为WiFi热点，客户端通过TCP Socket连接并控制该设备；
• 现有客户端是基于C#/WinForms开发的DesktopController，可正常连接硬件；
• 正在开发的Avalonia跨平台版本AvaloniaController，与DesktopController共享完全相同的网络代码；
• AvaloniaController在Windows平台能正常连接硬件，但在安卓平台连接时始终超时，报错：System.Net.Internals.SocketExceptionFactory+ExtendedSocketException (110): Connection timed out；
• 开发用的C#桌面模拟程序ServerSimulator，AvaloniaController在Windows和安卓平台都能正常连接，说明安卓端Socket代码本身无问题；
• 即使在Windows物理机的安卓模拟器中运行AvaloniaController，也无法连接硬件，排除物理安卓设备本身的问题。

连接核心代码如下：

public void Connect(string host, int port)
{
    IPAddress ipAddress;
    IPAddress.TryParse(host, out ipAddress);
    IPEndPoint ipe = new IPEndPoint(ipAddress, port);

    try
    {
        _tcpSocket = new Socket(ipe.AddressFamily, SocketType.Stream, ProtocolType.Tcp);

        // 安卓端会在此处停顿后抛出超时异常
        _tcpSocket.Connect(ipe);
    }
}

为何仅安卓→硬件的连接会超时？

结合场景核心矛盾（安卓环境与工业硬件TCP握手不兼容），以下是具体排查方向和解决办法：

1. 安卓网络权限配置缺失 #

安卓对网络权限的管控比Windows严格，即使能连接模拟服务器，也可能因权限细节无法连接工业硬件：

• 确认AndroidManifest.xml中已添加全量必要权限：

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

• 安卓10及以上版本，若硬件热点为私有局域网，需添加ACCESS_FINE_LOCATION权限并在运行时请求授权——系统要求定位权限才能访问私有WiFi网络内的设备。

2. 工业硬件TCP栈兼容性问题 #

工业设备的TCP栈通常简化，可能不支持安卓默认Socket参数：

• 延长连接超时时间：安卓默认超时可能偏短，或硬件响应慢，改用带超时的异步连接：

  _tcpSocket = new Socket(ipe.AddressFamily, SocketType.Stream, ProtocolType.Tcp);
  _tcpSocket.SendTimeout = 10000; // 10秒
  _tcpSocket.ReceiveTimeout = 10000;
  
  var connectTask = _tcpSocket.ConnectAsync(ipe);
  if (!connectTask.Wait(10000))
  {
      _tcpSocket.Close();
      throw new TimeoutException("连接超时");
  }
  

• 禁用Nagle算法：工业硬件对延迟敏感，安卓默认启用的Nagle算法可能导致握手延迟：

  _tcpSocket.NoDelay = true; // 关闭Nagle，减少小数据包延迟
  

• 强制使用IPv4：工业硬件可能仅支持IPv4，安卓可能优先尝试IPv6，手动指定IPv4：

  // 解析时优先选择IPv4地址
  if (!IPAddress.TryParse(host, out ipAddress))
  {
      var hostEntry = Dns.GetHostEntry(host);
      ipAddress = hostEntry.AddressList.FirstOrDefault(a => a.AddressFamily == AddressFamily.InterNetwork);
  }
  // 明确创建IPv4 Socket
  _tcpSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
  

3. 安卓网络路由与热点适配问题 #

安卓连接硬件热点时，可能存在路由规则异常：

• 确认安卓设备已获取硬件热点分配的同网段IP（例如硬件IP为192.168.1.1，安卓需获取192.168.1.x段地址）；
• 安卓模拟器中尝试手动设置静态IP，避免DHCP分配的地址与硬件不兼容；
• 关闭安卓设备的"私有DNS"功能（路径：设置→网络→私有DNS→选择"关闭"），部分私有热点会因DNS配置导致连接失败。

4. 工业硬件的连接限制 #

工业设备可能存在访问控制规则：

• 检查硬件配置界面，确认是否开启IP/MAC白名单，将安卓设备的MAC地址添加至允许列表；
• 查看硬件的连接日志，确认是否收到安卓端的连接请求、是否被设备主动拒绝。

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