Qt构建项目引入外部HTTPRequest头文件时出现undefined reference报错

云原生阿岚

2026-9-25

解决方案

你遇到的是Windows平台下的链接缺失错误，WSAStartup、WSACleanup都属于Windows套接字WinSock2的系统API，相关实现存放在系统库ws2_32中，你引入的HTTPRequest库底层调用了这些接口，但项目没有配置链接该系统库，因此出现符号找不到的报错。

修复步骤

打开项目的.pro配置文件，添加如下配置：
如果你只需要在Windows平台编译，可以直接加：
```
LIBS += -lws2_32
```
如果需要兼顾跨平台编译，可以加条件判断，只在Windows平台引入该链接规则：
```
win32 {
    LIBS += -lws2_32
}
```
修改完成后，在Qt Creator中依次执行「构建」→「执行qmake」，再重新构建项目即可消除报错。