Flutter Windows端TCP连接遇Semaphore超时错误求助

问题描述 #

我正在开发Windows平台的Flutter桌面应用，通过TCP套接字连接服务器35.152.55.91:5010时，频繁遇到以下错误：

SocketException: The semaphore timeout period has expired.
(OS Error: The semaphore timeout period has expired, errno = 121),
address = 35.152.55.91, port = 5010

已尝试的操作 #

• 检查网络连通性：使用ping和traceroute验证服务器可达
• 延长套接字超时时间：在Socket.connect()中设置timeout为Duration(seconds: 60)
• 实现指数退避重连：按2s、4s、8s等递增延迟重试连接
• 检查防火墙和杀毒软件设置：确保未拦截连接
• 多次重启服务器与客户端

相关代码 #

try {
  socket = await Socket.connect(ServerManager().ip, ServerManager().port,
      timeout: const Duration(seconds: 60));
  Logger.info("Connected to the server...");
} on SocketException catch (e) {
  Logger.error("Connection failed. Error: $e");
}

待解答问题 #

1. Flutter套接字连接中出现“The semaphore timeout period has expired”错误的原因是什么？
2. 在此场景下如何正确处理自动重连？
3. 是否存在Windows特定设置（如注册表/网络配置）可帮助解决该问题？

环境信息 #

• Flutter版本：[运行flutter doctor并填入输出]
• Dart版本：[运行dart --version并填入输出]
• 操作系统：Windows 10 / 11
• 网络：WiFi / 以太网连接
• 服务器操作系统：[Linux / Windows]

问题解答 #

1. 错误原因分析 #

这个错误（errno=121）是Windows系统层面的套接字超时错误，常见诱因包括：

• 网络链路不稳定：虽然ping和traceroute能通，但TCP握手阶段可能出现丢包、延迟波动，导致系统等待信号量超时
• 服务器资源瓶颈：服务器TCP连接队列已满，无法及时响应新请求，使得客户端等待超时
• Windows网络栈限制：系统默认TCP超时参数过小，或套接字资源未正确释放，引发信号量等待超时
• 中间设备限制：路由器、防火墙等设备的TCP会话超时设置过短，或对连接速率做了限制

2. 正确的自动重连实现 #

指数退避的思路可行，但需要补充以下细节优化：

• 设置最大重试上限：避免无限重试消耗资源，例如限制最多10次重试，之后触发用户提示
• 重试前检测网络状态：先检查本地网络可用性（如ping网关），避免无效重试
• 连接成功后重置参数：恢复重试延迟至初始值，下次断开时重新递增
• 监听连接后断开事件：通过套接字的done流捕获异常断开，触发重连
• 添加抖动机制：在指数延迟基础上加入±500ms随机抖动，避免多客户端同时重试压垮服务器

优化后的重连代码示例：

int _retryCount = 0;
final int _maxRetries = 10;
Duration _retryDelay = const Duration(seconds: 2);
final Random _random = Random();

Future<void> _connectToServer() async {
  try {
    socket = await Socket.connect(ServerManager().ip, ServerManager().port,
        timeout: const Duration(seconds: 60));
    Logger.info("Connected to the server...");
    // 重置重连参数
    _retryCount = 0;
    _retryDelay = const Duration(seconds: 2);
    // 监听连接断开事件
    socket?.done.then((_) {
      Logger.info("Disconnected from server, initiating reconnect...");
      _scheduleReconnect();
    }).catchError((e) {
      Logger.error("Connection error: $e");
      _scheduleReconnect();
    });
  } on SocketException catch (e) {
    Logger.error("Connection failed. Error: $e");
    _scheduleReconnect();
  }
}

void _scheduleReconnect() {
  if (_retryCount >= _maxRetries) {
    Logger.error("Max retries reached, please check network or server status.");
    return;
  }
  _retryCount++;
  // 添加随机抖动
  final jitter = Duration(milliseconds: _random.nextInt(1000) - 500);
  final actualDelay = _retryDelay + jitter;
  Logger.info("Reconnecting in ${actualDelay.inSeconds}s... (Attempt $_retryCount/$_maxRetries)");
  Future.delayed(actualDelay, _connectToServer);
  // 延迟递增，上限设为30s
  _retryDelay = Duration(seconds: _retryDelay.inSeconds * 2 > 30 ? 30 : _retryDelay.inSeconds * 2);
}

3. Windows特定优化设置 #

可通过调整系统网络配置缓解问题：

• 修改TCP相关注册表项：
  1. 打开注册表编辑器（regedit），导航到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters
  2. 新建DWORD值TcpMaxDataRetransmissions，设置为5（默认3，增加TCP重传次数）
  3. 新建DWORD值TcpTimedWaitDelay，设置为30（单位秒，缩短TIME_WAIT状态的连接持有时间）
  4. 重启电脑生效
• 调整网络适配器设置：
  1. 打开网络适配器属性，找到Internet 协议版本 4 (TCP/IPv4)，点击属性→高级
  2. 在高级TCP/IP设置中，勾选使用Tcp/IP自动调优，或手动将接收窗口大小设为65535
• 关闭Windows快速启动：
  路径：控制面板\硬件和声音\电源选项\选择电源按钮的功能→更改当前不可用的设置→取消勾选启用快速启动

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