ESP32软AP初始化：无法用const char*变量赋值wifi_config.ap.ssid

问题场景 #

编写ESP32的Soft-AP初始化函数时，尝试用const char*类型的ssid和password参数，在结构体初始化列表中直接给wifi_ap_config_t的数组字段赋值，触发编译错误：

missing braces around initializer [-Werror=missing-braces]

错误的赋值代码：

wifi_config_t wifi_config = {
    .ap = {
        .ssid = *ssid,
        .ssid_len = strlen(ssid),
        .channel = channel,
        .password = *password,
        .max_connection = max_conn,
        .authmode = WIFI_AUTH_WPA_WPA2_PSK},
};

对应的wifi_ap_config_t结构体定义：

typedef struct {
    uint8_t ssid[32];           /**< SSID of ESP32 soft-AP. If ssid_len field is 0, this must be a Null terminated string. Otherwise, length is set according to ssid_len. */
    uint8_t password[64];       /**< Password of ESP32 soft-AP. */
    uint8_t ssid_len;           /**< Optional length of SSID field. */
    uint8_t channel;            /**< Channel of ESP32 soft-AP */
    wifi_auth_mode_t authmode;  /**< Auth mode of ESP32 soft-AP. Do not support AUTH_WEP in soft-AP mode */
    uint8_t ssid_hidden;        /**< Broadcast SSID or not, default 0, broadcast the SSID */
    uint8_t max_connection;     /**< Max number of stations allowed to connect in, default 4, max 10 */
    uint16_t beacon_interval;   /**< Beacon interval which should be multiples of 100. Unit: TU(time unit, 1 TU = 1024 us). Range: 100 ~ 60000. Default value: 100 */
    wifi_cipher_type_t pairwise_cipher;   /**< pairwise cipher of SoftAP, group cipher will be derived using this. cipher values are valid starting from WIFI_CIPHER_TYPE_TKIP, enum values before that will be considered as invalid and default cipher suites(TKIP+CCMP) will be used. Valid cipher suites in softAP mode are WIFI_CIPHER_TYPE_TKIP, WIFI_CIPHER_TYPE_CCMP and WIFI_CIPHER_TYPE_TKIP_CCMP. */
    bool ftm_responder;         /**< Enable FTM Responder mode */
} wifi_ap_config_t;

问题根源 #

• wifi_ap_config_t中的ssid和password是固定长度的uint8数组，并非指针类型。用*ssid赋值只会传入字符串的第一个字符，类型不匹配触发编译器报错。
• 字符串常量能直接初始化数组是因为C语言支持字面量对字符数组的特殊初始化语法，但变量无法触发该语法。

正确实现方案 #

放弃在结构体初始化列表中直接赋值数组，先初始化非数组字段，再通过字符串拷贝函数将变量内容复制到数组中：

修改后的代码片段：

// 初始化结构体的非数组字段，数组字段会被默认清零
wifi_config_t wifi_config = {
    .ap = {
        .ssid_len = strlen(ssid),
        .channel = channel,
        .max_connection = max_conn,
        .authmode = WIFI_AUTH_WPA_WPA2_PSK
    },
};

// 安全拷贝SSID到数组，预留1字节给终止符防止溢出
strncpy((char*)wifi_config.ap.ssid, ssid, sizeof(wifi_config.ap.ssid) - 1);
wifi_config.ap.ssid[sizeof(wifi_config.ap.ssid) - 1] = '\0';

// 处理密码：非空时拷贝，空密码则设置开放认证
if (strlen(password) > 0) {
    strncpy((char*)wifi_config.ap.password, password, sizeof(wifi_config.ap.password) - 1);
    wifi_config.ap.password[sizeof(wifi_config.ap.password) - 1] = '\0';
} else {
    wifi_config.ap.authmode = WIFI_AUTH_OPEN;
}

关键注意点 #

• 使用strncpy而非strcpy，避免源字符串过长导致缓冲区溢出。
• 手动添加字符串终止符\0，因为strncpy在源字符串长度超过目标数组时不会自动添加终止符。
• 确保传入的ssid长度不超过31字节（数组总长度32），password长度不超过63字节（数组总长度64），符合ESP32的AP参数限制。

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