ASP.NET Web API登录API抛出“非阻塞套接字操作无法立即完成”错误怎么办

错误场景 #

在ASP.NET Web API项目的登录接口运行时，Socket.cs文件的DoConnect方法抛出错误：非阻塞套接字操作无法立即完成（原英文错误："A non-blocking socket operation could not be completed immediately."）

关联代码（Socket.cs中的DoConnect方法） #

private void DoConnect(EndPoint endPointSnapshot, SocketAddress socketAddress)
{
    SocketsTelemetry.Log.ConnectStart(socketAddress);
    SocketError errorCode;
    try
    {
        errorCode = SocketPal.Connect(_handle, socketAddress.Buffer.Slice(0, socketAddress.Size));
    }
    catch (Exception ex)
    {
        SocketsTelemetry.Log.AfterConnect(SocketError.NotSocket, ex.Message);
        throw;
    }

    // Throw an appropriate SocketException if the native call fails.
    if (errorCode != SocketError.Success)
    {
        UpdateConnectSocketErrorForDisposed(ref errorCode);
        // Update the internal state of this socket according to the error before throwing.
        SocketException socketException = SocketExceptionFactory.CreateSocketException((int)errorCode, endPointSnapshot);
        UpdateStatusAfterSocketError(socketException);
        if (NetEventSource.Log.IsEnabled()) NetEventSource.Error(this, socketException);

        SocketsTelemetry.Log.AfterConnect(errorCode);

        throw socketException;
    }

    SocketsTelemetry.Log.AfterConnect(SocketError.Success);

    if (NetEventSource.Log.IsEnabled()) NetEventSource.Info(this, $"connection to:{endPointSnapshot}");

    // Update state and performance counters.
    _pendingConnectRightEndPoint = endPointSnapshot;
    _nonBlockingConnectInProgress = false;
    SetToConnected();
    if (NetEventSource.Log.IsEnabled()) NetEventSource.Connected(this, LocalEndPoint, RemoteEndPoint);
}

解决办法 #

1. 切换为阻塞套接字模式 #

如果业务场景不需要非阻塞IO，可在创建Socket时显式设置为阻塞模式，这样Connect方法会等待连接完成或超时，不会抛出该错误：

Socket socket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
socket.Blocking = true; // 启用阻塞模式

2. 改用异步连接逻辑 #

若必须使用非阻塞模式，需用异步方法处理连接，避免同步调用的直接报错：

Socket socket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
socket.Blocking = false;
await socket.ConnectAsync(targetEndPoint); // 异步连接自动处理等待逻辑

3. 排查目标服务可用性 #

确认登录接口依赖的后端服务（如数据库、认证服务）是否正常运行、端口开放、网络通畅。目标服务过载或未响应时，非阻塞连接会立刻返回该错误。

4. 调整连接超时设置 #

针对阻塞模式或异步场景，设置合理的超时时间避免无限等待：

// 同步模式设置超时
socket.SendTimeout = 5000; // 5秒发送超时
socket.ReceiveTimeout = 5000; // 5秒接收超时

// 异步模式配合取消令牌实现超时
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
try
{
    await socket.ConnectAsync(targetEndPoint, cts.Token);
}
catch (OperationCanceledException)
{
    // 处理超时逻辑，比如重试或返回错误提示
}

5. 修复Socket封装逻辑 #

检查项目中自定义的Socket封装代码，确认是否误将套接字设为非阻塞模式，且未处理SocketError.WouldBlock的场景。比如在DoConnect方法中，若检测到该错误码，应启动异步等待连接完成，而非直接抛出异常。

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