PAYATHON 2026

Windows 更新后 bind() TCP socket 返回 WSAEACCES

排障赵师傅

结论

首先检查 Windows 的 TCP 排除端口范围(excluded port range)。系统更新以及 Hyper-V、WSL、容器、VPN、WinNAT 等组件都可能重新配置 TCP 端口保留。应用绑定到被排除的端口时,bind() 可能返回 WSAEACCES(10013)。

端口保留按协议分别管理,所以同一端口可能无法绑定 TCP,却能正常绑定 UDP。关闭防火墙或杀毒软件通常解决不了这个问题,因为端口排除发生在 TCP/IP 协议栈内部。

还要检查是否有其他程序通过 SO_EXCLUSIVEADDRUSE 独占了地址和端口。普通的端口占用通常会返回 WSAEADDRINUSE(10048),较少返回 WSAEACCES。

先检查 TCP 排除端口

在具有管理员权限的命令提示符或 PowerShell 中执行:

netsh interface ipv4 show excludedportrange protocol=tcp

输出中会列出普通应用无法绑定的 TCP 端口区间,检查应用所用端口是否落在其中。0x4000 对应的十进制数是 16384:

0x4000 = 16384

UDP 有单独的排除列表,可用以下命令对照:

netsh interface ipv4 show excludedportrange protocol=udp

如果 TCP 列表覆盖了从 16384 开始的若干端口,而 UDP 列表没有覆盖,那么 TCP bind() 全部失败、UDP 仍然正常的现象就能得到解释。

程序使用 IPv6 时,还要检查:

netsh interface ipv6 show excludedportrange protocol=tcp

检查动态端口范围

查看当前机器配置的动态端口范围:

netsh interface ipv4 show dynamicportrange protocol=tcp
netsh interface ipv4 show dynamicportrange protocol=udp

动态端口范围与排除端口范围是两套配置,但 Hyper-V、NAT、容器或其他系统组件可能会从动态范围中划出一部分端口。不同 Windows 机器的范围未必相同,某个端口以前可用,也不代表现在仍然可用。

检查端口是否已被占用

检查监听端口和所有 TCP 端点:

netstat -ano -p tcp

也可以按端口过滤。例如,检查 16384:

netstat -ano -p tcp | findstr ":16384"

取得 PID 后查询对应进程:

tasklist /fi "PID eq 1234"

也可以直接通过 PowerShell 查询:

Get-NetTCPConnection -LocalPort 16384 -ErrorAction SilentlyContinue |
    Format-Table LocalAddress, LocalPort, State, OwningProcess

netstat 只能发现实际存在的 TCP 端点,不能完整显示系统排除端口。因此,即使 netstat 没有输出,也不能确定该端口可以绑定。

用最小程序确认错误

诊断时,bind() 返回失败后应立即调用 WSAGetLastError(),以免后续 Winsock 调用覆盖错误码:

#include <stdio.h>
#include <winsock2.h>
#include <ws2tcpip.h>

#pragma comment(lib, "Ws2_32.lib")

int main(void)
{
    WSADATA wsa;
    SOCKET s = INVALID_SOCKET;
    struct sockaddr_in addr;
    int result = 1;

    if (WSAStartup(MAKEWORD(2, 2), &wsa) != 0) {
        fprintf(stderr, "WSAStartup failed\n");
        return 1;
    }

    s = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
    if (s == INVALID_SOCKET) {
        fprintf(stderr, "socket failed: %d\n", WSAGetLastError());
        goto cleanup;
    }

    ZeroMemory(&addr, sizeof(addr));
    addr.sin_family = AF_INET;
    addr.sin_addr.s_addr = htonl(INADDR_LOOPBACK);
    addr.sin_port = htons(16384);

    if (bind(s, (const struct sockaddr *)&addr, sizeof(addr)) == SOCKET_ERROR) {
        int error = WSAGetLastError();
        fprintf(stderr, "bind failed: %d\n", error);
        goto cleanup;
    }

    printf("bind succeeded\n");
    result = 0;

cleanup:
    if (s != INVALID_SOCKET)
        closesocket(s);

    WSACleanup();
    return result;
}

可以依次测试:

  • 当前使用的端口,例如 16384
  • 排除范围之外的高端口
  • sin_port = htons(0),由系统自动选择端口
  • INADDR_LOOPBACK
  • INADDR_ANY
  • 物理网卡当前实际拥有的 IPv4 地址

如果排除范围内的固定 TCP 端口返回 10013,而端口 0 和范围外的端口都能成功绑定,基本可以确定问题来自端口保留,与网卡、防火墙或应用代码无关。

恢复绑定的方法

更换应用端口

较稳妥的处理方式是把应用的固定端口迁移到当前机器未被占用或排除的范围,并允许通过配置文件修改端口。

如果这些端口只是产品内部约定,没有在正式注册机构登记,那么开发时未被占用,也不能保证以后不会与操作系统、第三方软件或其他服务冲突。

删除排除范围

确认某段排除范围已经不再被系统组件使用后,可以在管理员命令提示符中尝试删除:

netsh interface ipv4 delete excludedportrange protocol=tcp startport=16384 numberofports=20

startport 和 numberofports 必须与实际排除项一致,不能直接照搬示例值。

部分端口由 Hyper-V、WinNAT、容器平台或其他系统服务管理。即使使用管理员权限,删除命令也可能失败,或者相同的排除项会在重启后重新出现。遇到这种情况,应先查明端口保留的来源,再选择调整相关组件、停用不需要的功能或修改应用端口。强行删除系统仍在使用的保留项,可能破坏 NAT、虚拟网络或容器通信。

修改前可以保存当前配置:

netsh interface ipv4 show excludedportrange protocol=tcp > tcp-excluded-before.txt
netsh interface ipv4 show dynamicportrange protocol=tcp > tcp-dynamic-before.txt

修改或重启后再次导出,即可对比配置变化。

其他可能原因

SO_EXCLUSIVEADDRUSE

如果另一个进程先绑定了相同的地址和端口,并设置了 SO_EXCLUSIVEADDRUSE,后续调用 bind() 时可能得到 WSAEACCES。可以结合 PID、服务列表和最小测试程序确认占用者。

SO_REUSEADDR 不是通用解决办法。在 Windows 上,该选项可能允许多个 socket 绑定到同一端口,导致连接分配结果不确定,而且无法绕过系统排除端口。

服务器可以在绑定前明确要求独占端口:

BOOL exclusive = TRUE;

if (setsockopt(
        s,
        SOL_SOCKET,
        SO_EXCLUSIVEADDRUSE,
        (const char *)&exclusive,
        sizeof(exclusive)) == SOCKET_ERROR) {
    fprintf(stderr, "setsockopt failed: %d\n", WSAGetLastError());
}

这样可以减少端口共享产生的歧义,但无法使用已被系统保留或已被其他独占 socket 占用的端口。

绑定了本机并不拥有的地址

系统更新、网卡重装或接口配置变化后,指定的 IPv4 地址可能已经不再属于本机,此时绑定也会失败。这种情况通常返回 WSAEADDRNOTAVAIL(10049)。可通过以下命令确认当前地址:

ipconfig /all

HTTP URL ACL 与原始 Winsock 无关

netsh http show urlacl 管理 HTTP.sys 的 URL 预留。如果普通 native Winsock TCP 服务器没有使用 HTTP.sys,URL ACL 通常不会影响 bind(),因此不必优先修改 URL ACL。

建议的诊断顺序

  1. 在 bind() 失败后立即记录数值错误码,确认返回的是 10013。
  2. 将十六进制端口转换为十进制,逐项核对 TCP 排除范围。
  3. 使用 netstat 或 Get-NetTCPConnection 检查实际占用者。
  4. 分别测试原端口、范围外端口和端口 0。
  5. 检查近期是否启用了 Hyper-V、WSL、容器、VPN、WinNAT 或虚拟网卡组件。
  6. 优先迁移应用端口。只有确认排除项不再需要时,才考虑将其删除。

结合更新后突然出现、多个连续 TCP 端口同时失败以及 UDP 正常这些现象,最可能的原因是 TCP 专属的排除端口范围。具体仍要以 netsh interface ipv4 show excludedportrange protocol=tcp 的实际输出为准。

备注:内容仅供参考。