STM32 LWIP v1.11.2编译报错：HAL_ETH函数未定义/隐式声明

核心原因 #

LWIP v1.11.2是较早期版本，它依赖的HAL_ETH_BuildRxDescriptors、HAL_ETH_DescAssignMemory等函数，在新版STM32 HAL库（v2.x及以上）中已被重构或改名，而CubeMX默认生成的代码可能搭配了高版本HAL，导致兼容性不匹配。

具体解决步骤 #

• 切换适配的HAL库版本
  打开CubeMX，进入Project Manager -> Settings -> Firmware Package，选择对应MCU的HAL v1.x系列版本（比如STM32F4对应HAL v1.27.0，STM32H7对应HAL v1.10.0，可根据MCU型号查询官方兼容列表），重新生成代码。这是最直接的解决方式，能保证LWIP与HAL的API完全匹配。

• 检查CubeMX的LWIP/ETH配置

  1. 确认Connectivity -> ETH中选择了正确的物理层模式（MII/RMII），且启用了ETH外设。
  2. 进入Middleware -> LWIP，确保配置的LWIP版本与你安装的v1.11.2一致，且生成的ethernetif.c是CubeMX适配当前HAL的版本，而非你从GitHub下载的LWIP包中的旧文件。

• 手动补全缺失的HAL_ETH函数（适配新版HAL时用）
  如果必须使用新版HAL库，可参考旧版HAL的stm32xxxx_hal_eth.c实现，手动编写HAL_ETH_BuildRxDescriptors、HAL_ETH_DescAssignMemory等函数：

  1. 在stm32xxxx_hal_eth.h中添加函数声明，消除隐式声明警告。
  2. 在stm32xxxx_hal_eth.c中实现这些函数，逻辑参考旧版HAL的对应代码（比如描述符内存分配、接收描述符构建的逻辑）。

• 检查编译工程的文件包含
  确认工程中已添加stm32xxxx_hal_eth.c和stm32xxxx_hal_eth_ex.c文件，且头文件路径包含了HAL_ETH的头文件目录，避免编译器找不到函数定义或声明。

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