ESP-IDF问题：ESP32无法连接长SSID的WiFi网络

你的代码无法连接长SSID热点的核心问题在于**strlcpy调用未指定目标缓冲区长度**，同时缺少对SSID/密码长度的合法性检查。ESP-IDF定义的wifi_config_t结构体中，STA模式的SSID和密码缓冲区有固定大小限制：

• wifi_config.sta.ssid：uint8_t[32]，最多支持31个ASCII字符（需留1字节给字符串终止符\0）
• wifi_config.sta.password：uint8_t[64]，最多支持63个ASCII字符

当传入超过缓冲区容量的字符串时，未指定长度的strlcpy可能导致内存溢出、字符串未正确终止，最终让ESP32无法解析正确的SSID信息。

1. 修正strlcpy调用，指定缓冲区长度 #

修改StartConnect函数中的字符串拷贝逻辑，明确传入目标缓冲区的大小：

ReturnCode WifiMgr::StartConnect(char* ssid, char* pw) {
    esp_err_t err = ESP_OK;
    wifi_config_t wifi_config{};

    // 拷贝SSID，指定缓冲区大小为sizeof(wifi_config.sta.ssid)
    strlcpy(reinterpret_cast<char*>(wifi_config.sta.ssid), ssid, sizeof(wifi_config.sta.ssid));
    // 拷贝密码，指定缓冲区大小为sizeof(wifi_config.sta.password)
    strlcpy(reinterpret_cast<char*>(wifi_config.sta.password), pw, sizeof(wifi_config.sta.password));

    if (err == ESP_OK) {
        err = esp_wifi_set_config(WIFI_IF_STA, &wifi_config);
        if (err != ESP_OK) {
            LogError(("esp_wifi_set_config() failed: %s", esp_err_to_name(err)));
        }
    }

    if (err == ESP_OK) {
        connecting_ = true;

        LogInfo(("StartConnect(): Attempting to connect to ssid: %s", wifi_config.sta.ssid));

        err = esp_wifi_connect();
        if (err != ESP_OK) {
            LogError(("esp_wifi_connect() failed: %s", esp_err_to_name(err)));
            connecting_ = false;
        }
    }

    return (err == ESP_OK) ? ReturnCode::kSuccess : ReturnCode::kFailure;
}

2. 增加长度合法性检查（可选但推荐） #

在拷贝前先检查SSID和密码的长度，避免无效的连接尝试：

ReturnCode WifiMgr::StartConnect(char* ssid, char* pw) {
    esp_err_t err = ESP_OK;
    wifi_config_t wifi_config{};

    // 检查SSID长度（最多31字符，因为缓冲区是32字节含终止符）
    if (strlen(ssid) >= sizeof(wifi_config.sta.ssid)) {
        LogError(("SSID too long: max allowed is %d characters", sizeof(wifi_config.sta.ssid)-1));
        return ReturnCode::kFailure;
    }
    // 检查密码长度（最多63字符）
    if (strlen(pw) >= sizeof(wifi_config.sta.password)) {
        LogError(("Password too long: max allowed is %d characters", sizeof(wifi_config.sta.password)-1));
        return ReturnCode::kFailure;
    }

    strlcpy(reinterpret_cast<char*>(wifi_config.sta.ssid), ssid, sizeof(wifi_config.sta.ssid));
    strlcpy(reinterpret_cast<char*>(wifi_config.sta.password), pw, sizeof(wifi_config.sta.password));

    // 后续原有逻辑...
}

3. 验证事件回调中的SSID处理 #

在WIFI_EVENT_STA_DISCONNECTED回调中，你已经用%.*s正确处理了SSID的长度（避免截断或乱码），这部分逻辑是没问题的。如果连接失败，可以通过打印的reason码进一步排查：

• 常见失败原因码如WIFI_REASON_NO_AP_FOUND（未找到热点）、WIFI_REASON_AUTH_FAILED（认证失败），可以对应检查热点是否存在、密码是否正确。

• 802.11协议规定SSID最大长度为32字节（即31个ASCII字符），所以即使修改缓冲区也无法支持更长的SSID，这是协议层面的限制。
• 如果你的热点SSID超过31字符，这本身不符合标准，建议缩短SSID长度。

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