集成WiFiManager与ESPAsyncWebServer时遭遇HTTP_GET声明冲突错误

冲突原因 #

ESP8266WebServer（WiFiManager依赖它）和ESPAsyncWebServer两个库都定义了HTTP_GET宏，同时引入就会触发重复声明错误。

解决方案 #

方案1：改用AsyncWiFiManager（推荐） #

原生WiFiManager依赖同步的ESP8266WebServer，和异步的ESPAsyncWebServer天然冲突，换成适配异步服务器的AsyncWiFiManager可彻底解决问题：

• 卸载当前的WiFiManager库
• 安装AsyncWiFiManager库（选择适配ESP8266的版本）
• 修改头文件引用：
  • 删除<ESP8266WebServer.h>
  • 将<WiFiManager.h>替换为<AsyncWiFiManager.h>
• 调整代码实例化逻辑：
  原代码：

  WiFiManager wifiManager;
  

  修改为：

  ESPAsyncWebServer server(80);
  AsyncWiFiManager wifiManager(&server);
  

方案2：通过预处理宏隔离冲突（临时过渡方案） #

如果暂时不想更换库，可通过预处理指令重命名冲突宏：

// 先重命名ESP8266WebServer的HTTP_GET，避免和ESPAsyncWebServer冲突
#define HTTP_GET HTTP_GET_OLD
#include <DNSServer.h>
#include <ESP8266WebServer.h>
#include <WiFiManager.h>
// 恢复HTTP_GET为ESPAsyncWebServer的定义
#undef HTTP_GET

// 后续正常引入其他库
#include <ESP8266WiFi.h>
#include <WiFiUdp.h>
#include <ESP8266mDNS.h>
#include <ArduinoOTA.h>
#include <ESPAsyncTCP.h>
#include <ESPAsyncWebServer.h>
#include <SoftwareSerial.h> 
#include <dds238.h>

注意：此方法存在潜在风险，若WiFiManager内部对HTTP_GET的使用依赖原宏定义，可能引发逻辑错误，仅作为临时过渡使用。

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