ESP-IDF自定义组件引入官方MQTT库出现头文件缺失问题求助

问题根因 #

• 你自定义的组件命名为mqtt，和ESP-IDF内置组件重名，构建系统会优先匹配项目本地的自定义组件，导致依赖声明REQUIRES mqtt实际指向你自己开发的这个组件，无法关联到官方MQTT组件。
• ESP-IDF v4.3及以上版本中，官方MQTT组件的正确名称为esp-mqtt，依赖声明配置错误也会导致头文件引入失败。

正确配置方案 #

1. 重命名自定义组件文件夹：将/components/mqtt修改为任意不与官方组件冲突的名称，例如custom_mqtt
2. 修改/components/custom_mqtt/CMakeLists.txt内容如下：

idf_component_register(SRCS "mqtt.c"
                        INCLUDE_DIRS "include"
                        REQUIRES esp-mqtt esp-tls)

3. 清理历史编译缓存：删除项目根目录下的build文件夹和sdkconfig.old文件，重新执行编译即可正常引入官方MQTT组件的头文件和实现，无需硬编码任何绝对路径，完全符合ESP-IDF构建规范。

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