Swift OpenAPI Generator 中 URLSession 并发连接限制问题解析

问题背景

在使用 Swift OpenAPI Generator 进行服务器发送事件(SSE)开发时，开发者可能会遇到一个性能问题：当同时发起多个 SSE 请求时，后续请求会出现明显的延迟，甚至导致整个应用的网络请求都被阻塞。这个问题在使用 URLSessionTransport 时尤为明显，而使用 AsyncHTTPClientTransport 则表现正常。

问题现象

在典型的 SwiftUI 应用中，当列表中的每个项都需要建立独立的 SSE 连接时，开发者观察到：

1. 第一个连接能够立即建立并接收数据
2. 后续连接会延迟几秒才能建立
3. 在连接建立期间，应用的其他网络请求也会受到影响
4. 使用 AsyncHTTPClientTransport 时则没有这个问题

根本原因

经过深入分析，发现问题的根源在于 URLSession 的默认配置。URLSessionConfiguration 有一个关键属性 httpMaximumConnectionsPerHost，它控制着对同一主机的最大并发连接数。默认情况下，这个值被设置为 6。

当应用尝试建立超过 6 个到同一主机的并发连接时，额外的连接会被放入队列等待，直到有连接完成或被释放。这就是为什么开发者会观察到请求"挂起"的现象。

解决方案

要解决这个问题，可以通过以下方式调整 URLSession 的配置：

var urlSessionConfiguration = URLSessionConfiguration.default
urlSessionConfiguration.httpMaximumConnectionsPerHost = 100  // 调整为合适的值
let urlSession = URLSession(configuration: urlSessionConfiguration)
let client = Client(transport: URLSessionTransport(configuration: .init(session: urlSession)))

通过增加 httpMaximumConnectionsPerHost 的值，可以允许更多的并发连接，从而避免请求排队等待的情况。

最佳实践建议

1. 合理设置并发数：虽然可以设置很大的值，但应该根据实际需求和服务器能力进行调整。过高的并发数可能会导致服务器压力过大。

2. 连接管理：对于长时间保持的 SSE 连接，考虑实现连接池管理机制，避免无限制地创建新连接。

3. 架构设计：在 SwiftUI 应用中，应该将网络请求逻辑与视图分离，使用 ObservableObject 来管理状态和网络请求，避免视图重建导致的任务取消问题。

4. 性能监控：实现适当的日志和监控机制，及时发现和解决潜在的连接问题。

总结

URLSession 的默认并发连接限制是为了保护系统和服务器资源而设计的合理默认值。但在需要大量并发连接的特殊场景下，如 SSE 应用，开发者需要了解并适当调整这些配置参数。通过合理配置 URLSession，可以充分发挥 Swift OpenAPI Generator 在网络通信方面的能力，构建高性能的实时应用。