ESP-IDF中C结构体赋值致WiFi STA连接失败问题求助

核心差异：结构体初始化的完整性 #

代码A采用C语言聚合初始化方式，定义wifi_config_t变量时，未显式赋值的结构体成员会被自动初始化为对应类型的默认值（数值型为0、布尔型为false等），完全匹配ESP-IDF对wifi_sta_config_t的配置要求。

代码B仅手动赋值ssid和password字段，wifi_sta_config_t中其他关键字段（如scan_method、channel、bssid_set等）都是未初始化的随机垃圾值，这些无效值会干扰WiFi驱动的正常逻辑：

• 若scan_method被随机设为非有效值，驱动无法执行正确的AP扫描流程；
• 若channel被设为非0的无效频道（如大于13），驱动只会在错误频道扫描，无法找到目标AP；
• 若bssid_set被随机设为true但未配置bssid，驱动会尝试匹配不存在的AP MAC地址，导致扫描失败。

修复方案 #

需确保整个wifi_config_t结构体所有成员初始化为默认值，再自定义赋值需要的字段，以下两种方式均可靠：

方式1：聚合初始化默认值后赋值 #

static uint8_t wifi_ssid[32] = "my_ssid";
static uint8_t wifi_pwd[64] = "my_ssid_password";

// 先将整个结构体初始化为默认值0
wifi_config_t wifi_config = {0};

// 赋值SSID和密码
memcpy(wifi_config.sta.ssid, wifi_ssid, strlen((char*)wifi_ssid));
memcpy(wifi_config.sta.password, wifi_pwd, strlen((char*)wifi_pwd));

ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_STA, &wifi_config));

方式2：用memset初始化整个结构体 #

static uint8_t wifi_ssid[32] = "my_ssid";
static uint8_t wifi_pwd[64] = "my_ssid_password";

wifi_config_t wifi_config;
// 将结构体所有字节置0，确保所有成员使用默认值
memset(&wifi_config, 0, sizeof(wifi_config));

// 赋值SSID和密码
memcpy(wifi_config.sta.ssid, wifi_ssid, sizeof(wifi_ssid));
memcpy(wifi_config.sta.password, wifi_pwd, sizeof(wifi_pwd));

ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_STA, &wifi_config));

补充说明 #

ESP-IDF的WiFi驱动依赖wifi_sta_config_t的默认配置（如scan_method默认WIFI_FAST_SCAN、channel默认0表示全频道扫描），未初始化的随机值会破坏这些默认逻辑，最终导致AP扫描失败并返回WIFI_REASON_NO_AP_FOUND错误。

内容的提问来源于stack exchange，提问作者Trịnh Hữu Tâm