Serverpod项目中Socket连接异常问题分析与解决方案

问题背景

在Serverpod 2.2.0版本部署到Linux服务器时，开发者遇到了间歇性的SocketException异常，错误信息为"Connection reset by peer (OS Error: Connection reset by peer, errno = 104)"。这种连接重置问题通常发生在网络通信过程中，当一端意外关闭连接而另一端仍在尝试通信时。

问题分析

错误特征

1. 错误发生在服务器运行过程中，无明显规律
2. 错误指向HTTP服务器监听端口(7081)的连接问题
3. 服务器配置为1CPU/1GB内存，可能存在资源限制

可能原因

1. 客户端未正确关闭WebSocket连接：当Flutter客户端未正确取消订阅流时，可能导致服务器维持不必要的连接
2. 资源限制：1GB内存可能不足以处理大量并发连接
3. 连接超时：网络中间件(如负载均衡器)可能设置了连接超时

解决方案

客户端优化

关键修复点在于确保Flutter客户端正确管理StreamSubscription生命周期：

StreamSubscription<CountToken>? _streamSubscription;

@override
void dispose() async {
  await _streamSubscription?.cancel(); // 必须显式取消订阅
  super.dispose();
}

Future<void> _listenToUpdates(int windowId) async {
  final Stream<CountToken> statusUpdates = client.tokenIssued.echoStatusStream();
  try {
    _streamSubscription = statusUpdates.listen((update) {
      // 处理更新逻辑
    });
  } catch (e) {
    // 错误处理
  }
}

服务器端建议

虽然问题根源在客户端，但服务器端也可以做以下改进：

1. 连接监控：实现连接健康检查机制
2. 资源管理：优化内存使用，特别是对于WebSocket连接
3. 错误恢复：增强服务器对异常连接的恢复能力

最佳实践

1. 流式连接管理：

   • 始终在Widget的dispose()方法中取消订阅
   • 避免在build()方法中创建新订阅
   • 使用StatefulWidget管理有状态连接

2. 服务器资源优化：

   • 考虑增加服务器内存配置
   • 监控连接数量及内存使用情况
   • 实现连接空闲超时机制

3. 错误处理：

   • 客户端实现重连逻辑
   • 服务器记录详细连接日志
   • 设置合理的连接超时时间

总结

这个案例展示了在Serverpod项目中正确处理WebSocket连接的重要性。通过客户端正确管理StreamSubscription生命周期，可以有效避免"Connection reset by peer"错误。同时，合理的服务器资源配置和连接管理策略也是保证服务稳定性的关键因素。开发者应当特别注意在Flutter应用中及时释放不再需要的流式连接，以避免对服务器造成不必要的负担。