PAYATHON 2026

Win32 客户端调用 WSARecv 接收服务端响应时超时,如何排查?

数据小陈

目前没有提供实际接收函数 LgRecvNetworkData,因此仅凭这两段代码,无法确定 WSARecv 超时的唯一原因。不过,服务端发送代码有几处需要修正:它忽略了 WSASend 的调用结果,没有取得发送完成结果,还可能在等待超时后释放仍被异步操作使用的 WSAOVERLAPPED。

建议先记录发送是否成功、实际发送和接收了多少字节,再核对协议。单纯增加超时时间不足以解决这些问题。

先区分是哪一次等待超时

服务端的这段代码:

ret = WSAWaitForMultipleEvents(1,
    tmpevent, TRUE, 300, FALSE);

最多等待 300 毫秒,等待对象是服务端发送操作使用的事件,与客户端 WSARecv 的超时设置无关。发送完成也不表示客户端应用已经读到了响应。

排查时至少记录以下信息,并标明所属连接和请求:

  • 服务端是否执行到了 SvSendNetworkData,准备发送多少字节。
  • WSASend 的返回值,以及失败时立即取得的 WSAGetLastError()。
  • WSAWaitForMultipleEvents 的返回值。
  • 重叠操作最终的错误码和实际完成字节数。
  • 客户端 WSARecv 的返回值、错误码、每次实际接收的字节数,以及接收循环结束的条件。

如果等待函数返回 WSA_WAIT_TIMEOUT,应记录该返回值。随后读取的 WSAGetLastError() 可能来自更早的调用,不能把它当作这次超时的原因。

修正 WSASend 的结果处理

原代码丢弃了 WSASend 的返回值,直接等待事件,因此无法区分以下三种情况:

  1. 返回 0:发送操作已经同步完成。
  2. 返回 SOCKET_ERROR,错误码为 WSA_IO_PENDING:操作已提交,等待异步完成。
  3. 返回 SOCKET_ERROR,错误码不是 WSA_IO_PENDING:提交失败,应立即处理错误,不应继续等待这次发送完成。

等待事件时还要处理 WSA_WAIT_FAILED。事件触发后,应使用 WSAGetOverlappedResult 检查操作是否成功,并读取实际完成字节数。事件有信号,并不代表发送一定成功。

如果继续使用事件式重叠 I/O,每次复用同一个 WSAOVERLAPPED 前,都要确认上一笔操作已经结束,正确处理事件状态,并按完成字节数推进缓冲区位置。不能让尚未完成的操作共用同一个 WSAOVERLAPPED。

超时后不能直接释放异步操作的内存

原代码在等待超时后跳到清理逻辑:

if(ret == WSA_WAIT_TIMEOUT){
    ret2 = TFAILED;
    goto _lblfreeandexit;
}

等待超时只说明这次等待结束,不代表 WSASend 已经结束。此时直接释放 tmpwsaoverlp,可能导致仍在进行的操作访问失效内存。发送数据也必须在操作完成前保持有效且不被修改。

超时处理需要明确取消操作并回收完成结果。即使已经发起取消,也要确认操作最终完成后才能释放相关资源。

资源管理还有两处需要修正:

  • WSAEVENT tmpevent[1]; 没有初始化。如果前面的内存分配失败,清理代码可能读取未初始化的事件值。应初始化为 WSA_INVALID_EVENT。
  • WSACreateEvent 创建的事件应通过 WSACloseEvent 关闭;socket 有效性检查应使用 INVALID_SOCKET,而不是 NULL。

明确消息长度,不要扫描未知大小的内存

服务端通过连续两个 \0 寻找消息结束位置:

if((tmpstr[i] == '\0') &&
   (tmpstr[(i + 1)] == '\0')){
    break;
}

这要求 instr 指向的有效缓冲区足够大,并且确实包含双空字符结束标记。普通 C 字符串只保证有一个结尾 \0。例如,恰好容纳 32 个 GUID 字符和单个终止符的数组只有 33 字节,继续读取下一个字符就会越界。

循环上限 4094 不能证明输入缓冲区有这么大。如果扫描结束仍未找到标记,代码仍会计算长度并发送,也没有报告协议错误。

更稳妥的接口是显式传入长度,例如:

TRESULT SvSendNetworkData(SOCKET socket,
                         const char* data,
                         int length);

如果两端协议确实约定以 \0\0 结束,就显式构造这个结束标记;如果协议约定固定长度或长度前缀,两端都应按同一个规则处理。

用阻塞发送示例缩小排查范围

如果可以在独立工作线程中使用阻塞 socket,可以先用发送循环验证响应内容和协议,减少重叠 I/O 状态管理对排查的影响。下面的示例适用于已连接、处于阻塞模式的 TCP socket:

#include <winsock2.h>

bool SendAllBlocking(SOCKET socket,
                     const char* data,
                     int length,
                     int& wsaError)
{
    wsaError = 0;
    int total = 0;

    while (total < length) {
        int sent = send(socket, data + total, length - total, 0);

        if (sent == SOCKET_ERROR) {
            wsaError = WSAGetLastError();
            return false;
        }

        if (sent == 0) {
            return false;
        }

        total += sent;
    }

    return true;
}

// Only use this framing if the protocol requires two trailing NULs.
const char reply[] = "AD6D02632FB742539CEC5A0B961134E2\0";
int wsaError = 0;
bool ok = SendAllBlocking(
    socket,
    reply,
    static_cast<int>(sizeof(reply)),
    wsaError);

这个数组包含 32 个 GUID 字符、显式写入的一个 \0,以及字符串字面量自动添加的终止符,合计 34 字节。这里使用 sizeof 保留两个结束字符;strlen 不会把它们计入发送长度。

该示例没有实现操作超时,也不能直接替换非阻塞 socket 的发送逻辑。不要在窗口消息处理函数中执行可能长时间阻塞的网络操作。

检查客户端是否一直在等待不存在的数据

如果连接使用 TCP,一次发送不对应一次接收。即使服务端一次发送完整 GUID,客户端也可能分多次收到。接收缓冲区有 4096 字节,也不意味着必须收到 4096 字节才算一条消息完成。

LgRecvNetworkData 应累计实际接收字节,并按协议判断消息是否完整。如果协议使用双空字符标记,还要处理两个 \0 分别出现在两次接收中的情况。调用 strcmp 前,应保证缓冲区内存在有效的字符串终止符。

还要注意,成功完成的 TCP 接收返回零字节通常表示对端有序关闭连接,不应继续把它当作等待更多响应来处理。

核对这个函数独有的请求流程

客户端调用 LgHoursToEditNetworkString 生成了 tmpstr3 和 tmpn,但所示代码实际发送的是 PrepareNetworkData 根据请求 GUID 生成的 tmpstr2 和 tmpn2。

这不能直接证明漏发数据。如果协议要求先发送请求 GUID、收到许可后再发送业务数据,当前步骤可能符合设计。如果服务端必须先收到完整业务数据才返回 key,而客户端这里只发送请求 GUID 就立即等待响应,则可能造成双方互相等待。

应对照服务端接收处理代码确认顺序:客户端当前已经发送了什么,服务端此刻还在等待什么,以及返回 GUID 的分支是否真的执行。

客户端目前会把接收失败、服务端返回“未就绪”GUID 等情况最终统一显示为“服务器繁忙”。排查阶段应分别记录这些情况,并在每次重试前正确结束上一条连接,以便判断是业务状态、协议等待还是实际的网络错误。

备注:内容仅供参考。