ESP8266分文件使用ESPAsync_WiFiManager库出现链接报错

链接错误是两个机制问题叠加导致，另外你的代码还藏着一个会导致运行异常的逻辑bug：

1. PlatformIO库扫描失效：PlatformIO默认的库依赖查找器（LDF）对.hpp后缀的头文件识别存在兼容性问题，你在自定义头文件中引入ESPAsync_WiFiManager.hpp时，扫描器没有把ESPAsync_WiFiManager库加入编译和链接流程。你贴出的最终链接命令里，静态库列表完全没有libESPAsync_WiFiManager.a，链接器自然找不到类方法的对应实现。这也是为什么你把代码直接写在main.cpp里就能编译过——LDF对main.cpp直接引入的头文件识别优先级更高，不会漏扫。
2. hpp头文件的实现默认隐藏：khoih-prog提供的hpp合并头文件默认只对外暴露类声明，只有检测到是main.cpp引入时才会自动展开成员函数的实现代码。你在独立的wifi.cpp中引入时，没有触发实现展开的条件，进一步导致符号缺失。
3. 隐藏运行bug：你现在initWifi()函数里创建的AsyncWebServer和DNSServer是局部栈变量，函数执行完就会被析构，哪怕链接通过，配网服务也根本跑不起来。

按以下步骤操作即可100%解决：

1. 先修改项目根目录的platformio.ini，显式声明库依赖，彻底绕开LDF自动扫描的坑：

[env:nodemcu]
platform = espressif8266
board = nodemcuv2
framework = arduino
# 显式声明所有依赖，不要让PIO自动扫描
lib_deps =
    khoih-prog/ESPAsync_WiFiManager@^1.15.0
    ESPAsyncWebServer
    ESPAsyncTCP
    DNSServer
build_flags =
    -D HTTP_PORT=80
    -D AP_NAME=\"YOUR_CONFIG_AP_NAME\"

2. 修改wifi.h，把hpp头文件换成官方标准的.h头文件，不要用hpp：

#pragma once
#include <ESPAsync_WiFiManager.h>

namespace WiFiManagement 
{
    void initWifi();
}

3. 修改wifi.cpp，把WebServer和DNSServer对象挪到命名空间全局作用域，避免函数退出后对象被销毁：

#include "wifi.h"

namespace WiFiManagement
{
    // 全局生命周期对象，不会随函数退出析构
    AsyncWebServer  _ws(HTTP_PORT);
    DNSServer       _dnss;

    void initWifi(){
        ESPAsync_WiFiManager wifiManager(&_ws, &_dnss);
        wifiManager.autoConnect(AP_NAME);
    }
}

4. 执行pio run -t clean清理旧的编译缓存，再重新编译即可。

如果你坚持要用hpp头文件，只需要在引入hpp之前加一行#define ESP_ASYNC_WIFIMANAGER_IMPLEMENTATION即可，但还是推荐用标准.h引入+显式声明依赖的方案，稳定性最高，不会因为LDF版本更新出现兼容问题。

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