ESP32 esp-IDF引入第三方蓝牙头文件出现重定义与类型冲突报错

• 首先恢复官方SDK文件：你此前修改ESP-IDF自带esp_hid_gap.h添加第三方头文件引用的操作是核心错误诱因，先将所有官方SDK头文件恢复为原始状态，禁止修改任何ESP-IDF内置文件。
• 排查重定义错误：
  • 确认第三方bluetoothkeyboard组件完整性：不要仅复制单个bluetoothkeyboard.h文件，将原仓库中完整的bluetoothkeyboard组件目录复制到你项目根目录的components文件夹下（无该文件夹则新建），避免缺失实现文件导致链接错误，同时也能保证头文件保护逻辑正常生效，避免重复引入报错。
  • 处理命名冲突：如果你不需要同时使用ESP-IDF自带的HID主机功能，直接在SDK配置中关闭内置HID组件即可消除命名冲突：打开PlatformIO项目的SDK Configuration Editor，搜索ESP_HID，关闭ESP BLE HID Host相关选项即可。
• 解决链接错误（Collect2.exe: error: ld returned 1 exit status）：
  • 修改项目根目录CMakeLists.txt，添加第三方组件路径：

    cmake_minimum_required(VERSION 3.16.0)
    set(EXTRA_COMPONENT_DIRS components)
    include($ENV{IDF_PATH}/tools/cmake/project.cmake)
    project(TTGODemo)
    

  • 检查蓝牙功能配置：在SDK Configuration中确认Classic Bluetooth、BLE、BLE GATTC功能均已开启，蓝牙宿主选择Bluedroid，否则蓝牙相关依赖函数会报链接缺失。
• 若需同时使用两套HID组件：可对第三方库的冲突函数添加自定义前缀，或给冲突函数加static限定作用域，仅需修改少量代码，修改前备份原文件即可，不会影响库的核心功能。

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