FreeRTOS项目main.obj出现未解析外部符号_FreeRTOSIPInit问题求助

问题场景 #

正在开发基于FreeRTOS的项目，使用FreeRTOS+TCP功能，核心代码如下：

#include "FreeRTOS.h"
#include "FreeRTOS_IP.h"
#include "FreeRTOS_Sockets.h"

void tcp_send_task() {
    FreeRTOS_IPInit(NULL, NULL, NULL, NULL, NULL);
}

编译时出现链接错误：

LNK2019 unresolved symbol _FreeRTOSIPInit in function _tcp_send_task 

已配置C/C++附加包含目录（路径列表如下），但问题依旧：

..\..\..\FreeRTOS-Plus\Source\FreeRTOS-Plus-TCP\portable\NetworkInterface\WinPCap;
..\..\..\FreeRTOS-Plus\Source\FreeRTOS-Plus-TCP;
..\..\..\FreeRTOS-Plus\Source\FreeRTOS-Plus-TCP\portable\Compiler\MSVC;
..\..\..\FreeRTOS-Plus\Source\FreeRTOS-Plus-TCP\portable\BufferManagement;
..\..\..\FreeRTOS-Plus\Source\FreeRTOS-Plus-TCP\include;
..\..\Source\include;
..\..\Source\portable\MSVC-MingW;
..\Common\Include;
..\..\..\FreeRTOS-Plus\Source\FreeRTOS-Plus-Trace\Include;
.\Trace_Recorder_Configuration;
.;%(AdditionalIncludeDirectories)

推测函数声明已找到，但定义未被链接，尝试添加.c文件路径到链接器附加库目录无效。

解决方法 #

• 确认FreeRTOS+TCP核心源文件已加入项目
  附加包含目录仅让编译器找到头文件，链接器需要实际编译的目标文件。必须将以下关键.c文件添加到项目工程中：

  • FreeRTOS_IP.c（位于FreeRTOS-Plus/Source/FreeRTOS-Plus-TCP目录）
  • 对应BufferManagement的实现文件（如BufferAllocation_1.c，位于portable/BufferManagement目录）
  • 对应编译器的端口文件（如portable/Compiler/MSVC下的相关文件）
  • WinPCap网络接口的实现文件（portable/NetworkInterface/WinPCap下的NetworkInterface.c等）

• 检查预处理器宏定义
  确保项目中已定义FreeRTOS+TCP必需的宏，例如：

  • ipconfigUSE_TCP（启用TCP功能）
  • ipconfigUSE_IPv4（如果使用IPv4）
    这些宏通常在FreeRTOSIPConfig.h中配置，若未正确定义，FreeRTOS_IPInit可能不会被编译进目标文件。

• 核对函数名一致性
  检查代码中调用的FreeRTOS_IPInit是否与实际定义一致：
  报错中的符号是_FreeRTOSIPInit（无下划线），而代码中是FreeRTOS_IPInit（有下划线），这可能是宏定义导致的名字替换。检查FreeRTOS_IP.h中是否有类似#define FreeRTOS_IPInit FreeRTOSIPInit的宏，确保调用和定义匹配。

• 验证链接器设置
  如果使用预编译的FreeRTOS+TCP库文件，确保链接器的附加依赖项中已添加对应的库（如FreeRTOSPlusTCP.lib），且库的路径已加入附加库目录。若直接使用源文件，则无需此步骤，但需确认所有源文件都已被编译。

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