Compilation errors after updating ESPAsyncWebServer to the latest version (3.10.1+sha.9d9ebca)

[cniedzi]

Platform

ESP32

IDE / Tooling

Pioarduino

What happened?

Hi,

After updating ESPAsyncWebServer to the latest version, I'm getting the following compilation errors:

In file included from C:/Users/Czarek/.platformio/packages/framework-arduinoespressif32/libraries/WebServer/src/WebServer.h:30,
                 from .pio/libdeps/esp32s3/WiFiManager/WiFiManager.h:94,
                 from src/main.cpp:59:
C:/Users/Czarek/.platformio/packages/framework-arduinoespressif32/libraries/WebServer/src/HTTP_Method.h:7:18: error: expected identifier before '(' token
    7 | #define HTTP_ANY (HTTPMethod)(255)
      |                  ^
.pio/libdeps/esp32s3/ESPAsyncWebServer/src/ESPAsyncWebServer.h:100:3: note: in expansion of macro 'HTTP_ANY'
  100 |   HTTP_ANY = 0b0111111111111111,
      |   ^~~~~~~~
C:/Users/Czarek/.platformio/packages/framework-arduinoespressif32/libraries/WebServer/src/HTTP_Method.h:7:18: error: expected '}' before '(' token
    7 | #define HTTP_ANY (HTTPMethod)(255)
      |                  ^
.pio/libdeps/esp32s3/ESPAsyncWebServer/src/ESPAsyncWebServer.h:100:3: note: in expansion of macro 'HTTP_ANY'
  100 |   HTTP_ANY = 0b0111111111111111,
      |   ^~~~~~~~
In file included from src/main.cpp:61:
.pio/libdeps/esp32s3/ESPAsyncWebServer/src/ESPAsyncWebServer.h:84:32: note: to match this '{'
   84 | enum AsyncWebRequestMethodType {
      |                                ^
C:/Users/Czarek/.platformio/packages/framework-arduinoespressif32/libraries/WebServer/src/HTTP_Method.h:7:31: error: invalid conversion from 'int' to 'AsyncWebRequestMethod::AsyncWebRequestMethodType' [-fpermissive]
    7 | #define HTTP_ANY (HTTPMethod)(255)
      |                               ^~~
      |                               |
      |                               int
.pio/libdeps/esp32s3/ESPAsyncWebServer/src/ESPAsyncWebServer.h:100:3: note: in expansion of macro 'HTTP_ANY'
  100 |   HTTP_ANY = 0b0111111111111111,
      |   ^~~~~~~~
.pio/libdeps/esp32s3/ESPAsyncWebServer/src/ESPAsyncWebServer.h:100:12: error: expected ',' or ';' before '=' token
  100 |   HTTP_ANY = 0b0111111111111111,
      |            ^
.pio/libdeps/esp32s3/ESPAsyncWebServer/src/ESPAsyncWebServer.h:102:1: error: expected declaration before '}' token
  102 | };  // namespace AsyncWebRequestMethod
      | ^
.pio/libdeps/esp32s3/ESPAsyncWebServer/src/ESPAsyncWebServer.h: In member function 'AsyncCallbackWebHandler& AsyncWebServer::on(AsyncURIMatcher, ArRequestHandlerFunction)':
C:/Users/Czarek/.platformio/packages/framework-arduinoespressif32/libraries/WebServer/src/HTTP_Method.h:7:18: error: expected unqualified-id before '(' token
    7 | #define HTTP_ANY (HTTPMethod)(255)
      |                  ^
.pio/libdeps/esp32s3/ESPAsyncWebServer/src/ESPAsyncWebServer.h:1559:54: note: in expansion of macro 'HTTP_ANY'
 1559 |     return on(std::move(uri), AsyncWebRequestMethod::HTTP_ANY, onRequest);
      |                                                      ^~~~~~~~
C:/Users/Czarek/.platformio/packages/framework-arduinoespressif32/libraries/WebServer/src/HTTP_Method.h:7:19: error: reference to 'HTTPMethod' is ambiguous
    7 | #define HTTP_ANY (HTTPMethod)(255)
      |                   ^~~~~~~~~~
.pio/libdeps/esp32s3/ESPAsyncWebServer/src/ESPAsyncWebServer.h:1559:54: note: in expansion of macro 'HTTP_ANY'
 1559 |     return on(std::move(uri), AsyncWebRequestMethod::HTTP_ANY, onRequest);
      |                                                      ^~~~~~~~
C:/Users/Czarek/.platformio/packages/framework-arduinoespressif32/libraries/WebServer/src/HTTP_Method.h:7:19: note: candidates are: 'AsyncWebRequestMethod::AsyncWebRequestMethodType AsyncWebRequestMethod::HTTPMethod'
    7 | #define HTTP_ANY (HTTPMethod)(255)
      |                   ^~~~~~~~~~
.pio/libdeps/esp32s3/ESPAsyncWebServer/src/ESPAsyncWebServer.h:100:3: note: in expansion of macro 'HTTP_ANY'
  100 |   HTTP_ANY = 0b0111111111111111,
      |   ^~~~~~~~
C:/Users/Czarek/.platformio/packages/framework-arduinoespressif32/libraries/WebServer/src/HTTP_Method.h:6:26: note:                 'typedef enum http_method HTTPMethod'
    6 | typedef enum http_method HTTPMethod;
      |                          ^~~~~~~~~~
.pio/libdeps/esp32s3/ESPAsyncWebServer/src/WebHandlerImpl.h: In constructor 'AsyncCallbackWebHandler::AsyncCallbackWebHandler()':
C:/Users/Czarek/.platformio/packages/framework-arduinoespressif32/libraries/WebServer/src/HTTP_Method.h:7:18: error: expected unqualified-id before '(' token
    7 | #define HTTP_ANY (HTTPMethod)(255)
      |                  ^
.pio/libdeps/esp32s3/ESPAsyncWebServer/src/WebHandlerImpl.h:65:70: note: in expansion of macro 'HTTP_ANY'
   65 |   AsyncCallbackWebHandler() : _uri(), _method(AsyncWebRequestMethod::HTTP_ANY), _onRequest(NULL), _onUpload(NULL), _onBody(NULL), _isRegex(false) {}
      |                                                                      ^~~~~~~~
C:/Users/Czarek/.platformio/packages/framework-arduinoespressif32/libraries/WebServer/src/HTTP_Method.h:7:19: error: reference to 'HTTPMethod' is ambiguous
    7 | #define HTTP_ANY (HTTPMethod)(255)
      |                   ^~~~~~~~~~
.pio/libdeps/esp32s3/ESPAsyncWebServer/src/WebHandlerImpl.h:65:70: note: in expansion of macro 'HTTP_ANY'
   65 |   AsyncCallbackWebHandler() : _uri(), _method(AsyncWebRequestMethod::HTTP_ANY), _onRequest(NULL), _onUpload(NULL), _onBody(NULL), _isRegex(false) {}
      |                                                                      ^~~~~~~~
C:/Users/Czarek/.platformio/packages/framework-arduinoespressif32/libraries/WebServer/src/HTTP_Method.h:7:19: note: candidates are: 'AsyncWebRequestMethod::AsyncWebRequestMethodType AsyncWebRequestMethod::HTTPMethod'
    7 | #define HTTP_ANY (HTTPMethod)(255)
      |                   ^~~~~~~~~~
.pio/libdeps/esp32s3/ESPAsyncWebServer/src/ESPAsyncWebServer.h:100:3: note: in expansion of macro 'HTTP_ANY'
  100 |   HTTP_ANY = 0b0111111111111111,
      |   ^~~~~~~~
C:/Users/Czarek/.platformio/packages/framework-arduinoespressif32/libraries/WebServer/src/HTTP_Method.h:6:26: note:                 'typedef enum http_method HTTPMethod'
    6 | typedef enum http_method HTTPMethod;
      |                          ^~~~~~~~~~
Compiling .pio\build\esp32s3\lib512\Adafruit ILI9341\Adafruit_ILI9341.cpp.o
Compiling .pio\build\esp32s3\lib931\AsyncUDP\AsyncUDP.cpp.o
Compiling .pio\build\esp32s3\lib6f4\DNSServer\DNSServer.cpp.o
Compiling .pio\build\esp32s3\libb05\ESPmDNS\ESPmDNS.cpp.o
src/main.cpp: In function 'void setupAsyncServer()':
src/main.cpp:2441:18: error: reference to 'HTTP_GET' is ambiguous
 2441 |   Server.on("/", HTTP_GET, [](AsyncWebServerRequest *request){
      |                  ^~~~~~~~
.pio/libdeps/esp32s3/ESPAsyncWebServer/src/ESPAsyncWebServer.h:85:3: note: candidates are: 'AsyncWebRequestMethod::AsyncWebRequestMethodType AsyncWebRequestMethod::HTTP_GET'
   85 |   HTTP_GET = 0b0000000000000001,
      |   ^~~~~~~~
In file included from C:/Users/Czarek/.platformio/packages/framework-arduinoespressif32/libraries/WebServer/src/HTTP_Method.h:4:
C:/Users/Czarek/.platformio/packages/framework-espidf/components/http_parser/http_parser.h:138:31: note:                 'http_method HTTP_GET'
  138 | #define XX(num, name, string) HTTP_##name = num,
      |                               ^~~~~
C:/Users/Czarek/.platformio/packages/framework-espidf/components/http_parser/http_parser.h:96:3: note: in expansion of macro 'XX'
   96 |   XX(1,  GET,         GET)          \
      |   ^~
C:/Users/Czarek/.platformio/packages/framework-espidf/components/http_parser/http_parser.h:139:3: note: in expansion of macro 'HTTP_METHOD_MAP'
  139 |   HTTP_METHOD_MAP(XX)
      |   ^~~~~~~~~~~~~~~
src/main.cpp:2450:33: error: reference to 'HTTP_POST' is ambiguous
 2450 |   Server.on("/upload_playlist", HTTP_POST, [](AsyncWebServerRequest *request) {

There are libraries used in my project:

Platform espressif32 @ 55.3.37+sha.a9fac07 (required: git+https://github.com/pioarduino/platform-espressif32.git)
├── contrib-piohome @ 3.4.4 (required: C:\Users\Czarek\.platformio\packages\contrib-piohome)
├── framework-arduinoespressif32 @ 3.3.7 (required: https://github.com/espressif/arduino-esp32/releases/download/3.3.7/esp32-core-3.3.7.tar.xz)
├── framework-arduinoespressif32-libs @ 5.5.0+sha.87912cd291 (required: https://github.com/espressif/arduino-esp32/releases/download/3.3.7/esp32-core-3.3.7-libs.tar.xz)
├── framework-espidf @ 3.50502.0 (required: https://github.com/pioarduino/esp-idf/releases/download/v5.5.2.260206/esp-idf-v5.5.2.tar.xz)
├── tool-cmake @ 4.0.3 (required: C:\Users\Czarek\.platformio\packages\tool-cmake)
├── tool-esp-rom-elfs @ 2024.10.11 (required: C:\Users\Czarek\.platformio\packages\tool-esp-rom-elfs)
├── tool-esptoolpy @ 5.1.2 (required: C:\Users\Czarek\.platformio\packages\tool-esptoolpy)
├── tool-ninja @ 1.13.1 (required: C:\Users\Czarek\.platformio\packages\tool-ninja)
├── tool-scons @ 4.40801.0 (required: C:\Users\Czarek\.platformio\packages\tool-scons)
└── toolchain-xtensa-esp-elf @ 14.2.0+20251107 (required: C:\Users\Czarek\.platformio\packages\toolchain-xtensa-esp-elf)

Libraries
├── Adafruit GFX Library @ 1.12.5+sha.7ab6d09 (required: git+https://github.com/adafruit/Adafruit-GFX-Library)
│   └── Adafruit BusIO @ 1.17.4 (required: Adafruit BusIO)
├── Adafruit ILI9341 @ 1.6.3+sha.dbb447a (required: git+https://github.com/adafruit/Adafruit_ILI9341)
│   ├── Adafruit STMPE610 @ 1.1.6 (required: Adafruit STMPE610)
│   ├── Adafruit TSC2007 @ 1.1.2 (required: Adafruit TSC2007)
│   │   └── Adafruit SH110X @ 2.1.14 (required: Adafruit SH110X)
│   └── Adafruit TouchScreen @ 1.1.6 (required: Adafruit TouchScreen)
├── Adafruit ST7735 and ST7789 Library @ 1.11.0+sha.62112b9 (required: git+https://github.com/adafruit/Adafruit-ST7735-Library)
│   └── Adafruit seesaw Library @ 1.7.9 (required: Adafruit seesaw Library)
├── ESP32-audioI2S @ 3.4.5+sha.1c5ac3a (required: git+https://github.com/schreibfaul1/ESP32-audioI2S.git)
├── ESPAsyncWebServer @ 3.10.1+sha.9d9ebca (required: git+https://github.com/ESP32Async/ESPAsyncWebServer)
│   └── AsyncTCP @ 3.4.10 (required: ESP32Async/AsyncTCP @ ^3.4.10)
├── LovyanGFX @ 1.2.19+sha.4299835 (required: git+https://github.com/lovyan03/LovyanGFX)
└── WiFiManager @ 2.0.17+sha.4131fe6 (required: git+https://github.com/tzapu/WiFiManager)

Should I update anything else?

Stack Trace

n/a

Minimal Reproductible Example (MRE)

n/a

I confirm that:

• I have read the documentation.
• I have searched for similar discussions.
• I have searched for similar issues.
• I have looked at the examples.
• I have upgraded to the lasted version of ESPAsyncWebServer (and AsyncTCP for ESP32).

[mathieucarbou]

@cniedzi : Hi, can you share a little bit more about your project and your includes ? This happens because the asyncws enum names conflicts with the ones coming from Arduino webserver, that you might include directly or transitively.

You can either fix your includes, or add -D ASYNCWEBSERVER_NO_GLOBAL_HTTP_METHODS=1 to your compile path so that asyncws enum are no more in the global namepsace, but you will have to prefix all enum usages of asyncws with AsyncWebRequestMethod::

[cniedzi]

@cniedzi : you need to be careful about the ordering:

#include "WiFiManager.h" // (https://github.com/tzapu/WiFiManager)
#undef HTTP_ANY

#include "AsyncTCP.h"
#include "ESPAsyncWebServer.h"

HTTP_ANY is a macro defined by Arduino and only used in the context of the webserver. It needs to be undefined before including and using asyncws include which has this enum: AsyncWebRequestMethod::HTTP_ANY

With @willmmiles we are working on a PR to further refactor the asyncws code to make it easier to play nice with Arduino macro-defined enum, which is a pre-compilation processing sadly taking over all the other definitions. But there is no magic: in any case it will involve namespacing the enums, eventually use HTTP_ALL instead of HTTP_ANY (up to be decided still), and eventually use undef also...

On a side note... If you need a complete network manager with Captive Portal support and ETH support fully compatible with asyncws, you can also have a loot at MycilaESPConnect ;-)

Thanks @mathieucarbou

Indeed, it was my mistake with the #undef HTTP_ANY ordering.

I assume that before undefining HTTP_ANY, this macro will be compiled and remain available for the Arduino WebServer if needed later in the code?

Personally, adding a namespace before the method is not an issue for me at all. If you ask me, replacing HTTP_ANY with HTTP_ALL might indeed be the best solution.

Regarding MycilaESPConnect, please add OTA Update functionality and I’m all yours. :)

[mathieucarbou]

For OTA I am using ElegantOTA or, for bigger apps, MycilaSafeboot which is an interested concept of moving the OTA feature into a small recovery partition to remove the requirement of having 2 app partitions of same size which is a 50% loss of the MCU flash space. Instead we can have one big app partition less limited in size: more than 3MB on a 4MB flash for example.

[cniedzi]

MycilaSafeboot

Thank you, I will take a look at both Mycilas - they look great!

[mathieucarbou]

@cniedzi FYI the solution we have merged and releases had a side effect so the solution I gave you to undef HTTP_ANY for now is temporary.

[cniedzi]

@cniedzi FYI the solution we have merged and releases had a side effect so the solution I gave you to undef HTTP_ANY for now is temporary.

Thanks for letting me know. Fingers crossed for the ultimate solution!

[cniedzi]

Hi, Should I remove the AsyncWebRequestMethod:: prefix and #undef HTTP_ANY? sob., 14 mar 2026 o 14:19 Mathieu Carbou ***@***.***> napisał(a):

…

@cniedzi <https://github.com/cniedzi> : if you want to test this PR: #407 <#407> by pointing to branch fix/402 lib_deps = https://github.com/ESP32Async/ESPAsyncWebServer#fix/402 — Reply to this email directly, view it on GitHub <#402 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AVPAFIAJ2JL6V733L7XVONT4QVL7LAVCNFSM6AAAAACWRJAGHOVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTMMJTGAZDGMA> . You are receiving this because you were mentioned.Message ID: <ESP32Async/ESPAsyncWebServer/repo-discussions/402/comments/16130230@ github.com>

[mathieucarbou]

yes you should not need that. Only people having conflicts with arduino or esp-idf http method enums should prefix.

Sorry! Confusion with another issue ;-)
yes for people using both enum, you will have to prefix with the namespace...

#undef HTTP_ANY you won't need I think.

We are currently working on a solution: #413
So until it is done, you can do the workaround I gave you with the undef.

[cniedzi]

Looks like it works without any prefix and without #undef HTTP_ANY. Thanks! sob., 14 mar 2026 o 18:11 Mathieu Carbou ***@***.***> napisał(a):

…

yes you should not need that. Only people having conflicts with arduino or esp-idf http method enums should prefix. — Reply to this email directly, view it on GitHub <#402 (reply in thread)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AVPAFIF3M6TSCUW6OJFLQQD4QWHCNAVCNFSM6AAAAACWRJAGHOVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTMMJTGE4DQNY> . You are receiving this because you were mentioned.Message ID: <ESP32Async/ESPAsyncWebServer/repo-discussions/402/comments/16131887@ github.com>

[mathieucarbou]

@cniedzi could you please test again your code with main branch ? Pr is merged and we will release next week. Thanks !

[cniedzi]

@cniedzi could you please test again your code with main branch ? Pr is merged and we will release next week. Thanks !

Hi, @mathieucarbou I've tested with the @ 3.10.1+sha.e1bd972 and it still works without any prefixes and without #undef HTTP_ANY.